DB2 Server for VSE & VM: Operation

Starting the Online Support

The online support allows the users at CICS terminals to communicate with the application server. A major part of the online support is the online resource adapter, which manages the communications between online (CICS) users and the application server.

The CICS sequential device support can be used to automatically initiate the CIRB transaction. See the DB2 Server for VSE System Administration, or DB2 Server for VM System Administration for more information about automatically initiating the CIRB transaction.

If the CIRB transaction has not been automatically initiated, to start the online support:

  1. Ensure that the database manager is running.
  2. Ensure that CICS is running.
  3. Run the CICS transaction named CIRB on a CICS terminal.

CIRB has six parameters: 



>>-CIRB----+-,---------+---+-,--------+---+-,-------+----------->
           '-password,-'   '-nolinks,-'   '-defuid,-'
 
>-----+-,-----+---+-,-------+----------------------------------->
      '-rmid,-'   '-langid,-'
 
                       (1)
      .-Default_server-----------------------.
>-----+--------------------------------------+-----------------><
      +-server_name--------------------------+
      |          .-,--------------.          |
      |          V                |          |
      '-(-+---+-----server_name---+---+---+--'
          '-,-'                       '-)-'


Notes:



  1. The default server is determined from the DBNAME directory.


The parameters are described below.

Note:If the CIRB transaction ends abnormally, enter a CIRT QUICK transaction to end the online resource adapter before re-issuing a subsequent CIRB transaction.

Parameter Default Description

PASSWORD
(positional
parameter 1)

SQLDBAPW This parameter establishes the operator's authority to activate online access to the application server. The password identifies the CICS subsystem. The user ID of the subsystem is the CICS APPLID, which defaults to DBDCCICS. The procedure ARIS080D uses the following job control to give the password and user ID to the application server. 
// EXEC ARISQLDS,SIZE=AUTO,PARM='SYSMODE=S,           X
LOGMODE=N,PROGNAME=ARIDBS'
CONNECT SQLDBA IDENTIFIED BY SQLDBAPW;
GRANT SCHEDULE TO DBDCCICS IDENTIFIED BY CICSPSWD;
COMMIT WORK;
The password chosen (CICSPSWD above) must satisfy DB2 Server for VSE specifications for a password. This password establishes which password to use when dropping connections through the CIRR or CIRT commands.

NOLINKS
(positional
parameter 2)

3 This parameter establishes the number of links (paths) that should be initialized to the application server. Specify this parameter as a decimal value between 1 and 64. The number must be less than or equal to the value assigned to the NCUSERS initialization parameter of the application server. (The NCUSERS default is 5.)

DEFUID
(positional
parameter 3)

CICSUSER This parameter identifies the default user ID used by the online support when it makes an implicit CONNECT to a local application server. This parameter must satisfy DB2 Server for VSE specifications for a user ID.

RMID


(positional
parameter 4)

0 This parameter identifies a unique resource adapter. You must specify it only if your installation has multiple CICS partitions active in the same VSE/ESA system, and if each CICS partition allows online access to the application server. For this case, recovery requires that the application server know the resource adapter it is servicing. You must specify this parameter as a decimal value between 0 and 63.

If the online support detects that this ID is not unique in the system, it issues a message. The CIRB transaction then ends without enabling the resource adapter.

There can be only one resource adapter enabled in a single CICS partition. An attempt to enable a second resource adapter causes the online support to issue a message, and the CIRB transaction ends without enabling the second resource adapter. The first one, however, remains in effect.


LANGID
(positional
parameter 5)

specified at installation

This parameter defines the language the application server uses to display error and information messages. The language you specify on this transaction becomes the default language for ISQL, CBND, DSQG, DSQU, DSQQ and DSQD. The ISQL welcome logo always appears in the language specified on this transaction.

This parameter must take the form of a minimum 1-character, maximum 5-character language ID (in VM, this is consistent with CMS language IDs). In the case where a national language is not supported by CMS, but it is supported by the database manager, the database manager has adopted its own langid for the language. You must use one of the language IDs in the LANGID column of the SQLDBA.SYSLANGUAGE table. The language ID must identify a language you have installed on the database manager. To choose another language, use the SET LANGUAGE command in ISQL. The following IDs can be specified on the CIRB transaction:

AMENG
American English
UCENG
Uppercase English
FRANC
French
GER
German
KANJI
Kanji (Japanese)
HANZI
Simplified Chinese

If this parameter is omitted, the language defaults to the language chosen as the default at installation.


SERVER_NAME
(positional
parameter 6)

Determined from DBNAME directory or "SQLDS." This parameter enables you to specify the application servers that you want to access. If the list format specifies multiple servers, the first one in the list becomes the default server. Only the first server_name in the list may be omitted.

If this parameter (or the first one in the list) is omitted, the default server is determined from the DBNAME directory. If the DBNAME directory does not specify a default server, then SQLDS becomes the default server name.

[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]