Previous Topic: INQ=GENOPTS: Displaying System Generation OptionsNext Topic: INQ=PTF: Displaying Software Maintenance Levels


Display Examples:

z/OS Example: DBOC INQ=GENOPTS

DBOC INQ=GENOPTS DELIM & CA Datacom CICS Services Version: 14.0 Copyright 2011 CA. All rights reserved. 05/08/12 OPSYS=Z/OS 1.13 CICS LEVEL=TS 4.1 DB RELS=14.0 DB SVCID=000 SUB ID=255 MUF JOBNM=DBDVMW MAXURTS=2000 PREFIX=DBURT DYNPPT=YES USERS=010 SKIPURT=NO LOG=(YES,NO ) SYSVIEW=NO PLANSWI=NO USERID=NO TRACE=(ON , 1000) AUXTRACE=ON AUXTRACE LOG=DCAX DELIM=& MSGLOG=DBOC SCROLL=(MANUAL SEC ) DBEC=DBEC DBEX DBRC DBOC=DBOC DBIC DBKC DBUG=DBUG DBFS DBTS=DBTS DBTX OPENAPI=NO EOJ_OK=DISCONNECT REQTHD=00000 EXEMPT TRANS=DBOC OPERID=*** DC00380I TRANSACTION COMPLETED.

z/VSE Example: DBIC INQ=GENOPTS

DBIC INQ=GENOPTS                                                       DELIM &    CA Datacom CICS Services Version 14.0    Copyright © 2011 CA. All rights reserved. 04/12/11  OPSYS=Z/VSE  4.3             CICS LEVEL=TS 1.1.1      DB RELS=12 SP0  DB SVCID=246                  SUB id=006               MUF JOBNM=MUF110A  DB TARGET SVC=246             TARGET SUBID=006         VM ID  =VSEDC16    MAXURTS=0998                  PREFIX=DBURT             DYNPPT=NO  USERS=010                     SKIPURT=NO               LOG=(YES,NO )  SYSVIEW=NO                    PLANSWI=NO               USERID=YES  TRACE=(ON ,01000)             AUXTRACE=OFF             AUXTRACE LOG=DCAX  DELIM=&                       MSGLOG=DBOC              SCROLL=(AUTO   SEC 10)  DBEC=DBEC DBEX DBRC           DBOC=DBOC DBIC DBKC      DBUG=DBUG DBFS  DBTS=DBTS DBTX OPENAPI=NO EOJ OK=NO  REQTHD=00000 EXEMPT TRANS=DBOC  OPERID=***   DC00380I  TRANSACTION COMPLETED.

Field Descriptions
AUXTRACE=

Indicates whether CA Datacom CICS Services Auxiliary Trace Facility is initiated.

AUXTRACE LOG=

Indicates the destination for data from the Auxiliary Trace Facility.

CICS LEVEL=

Specifies the release level of CICS in use on this system.

DB RELS=

The release level of CA Datacom/DB in use on this system.

(CA Datacom CICS Services does not display a value in this field if no MUF has been connected.)

Note: The value that is displayed for DB RELS= is fetched from the release level of program DBINRPR, which is loaded into the CICS address space. Be aware, that for the DBEC transaction, the value that is displayed for DB RELS= is fetched instead from the MUF.

DB SVCID=

The ID number of the CA Datacom/DB SVC.

DB TARGET SVC=

In z/VSE environments, specifies the SVC number of the MUF to which requests are sent. The CA Datacom/DB interface executing in the application region to establish communication with the correct MUF uses this parameter. This value must match the SVC parameter value of the DBSIDPR.

Note: For more information, see the VMSVC= information in the CA Datacom/DB Database and System Administration Guide.

DBEC=

Displays the transaction IDs used to initiate the CA Datacom CICS Services enhanced functions.

DBOC=

Displays two transaction IDs used to initiate the CA Datacom CICS Services operational functions.

DBTS=

Displays the transaction IDs used to initiate the Test Facility in update and read-only mode. The first displayed transaction is used to invoke the functions that are documented for the DBTS transaction (update mode). The second displayed transaction is used to invoke the functions that are documented for DBTX (read-only mode).

DBUG=

Displays the transaction IDs used to initiate the Debugging Facility. The first displayed transaction is used to invoke the functions that are documented for the DBUG transaction. The second displayed transaction is internal ID used when debugging a remote terminal.

DELIM=

The current command delimiter specification. For an explanation of the command delimiter, see Issuing Multiple Operational Commands.

DYNPPT=

YES specifies that you want to use the program AUTOINSTALL function (PGAIPGM=ACTIVE in DFHSIT) for the URTs. NO specifies that you do not want to autoinstall URTs, but instead want them to be defined in the CSD.

EOJ OK=

This value represents CA Datacom CICS Services participation in an EOJ being issued for the default MUF. A value of No indicates that CA Datacom CICS Services does not participate in the EOJ of MUF meaning that MUF cannot EOJ until the MUF is disconnected in CA Datacom CICS Services. The value of DISCONNECT or IMMEDIATE determines the CA Datacom CICS Services action when notified of a MUF EOJ. If these two values are specified and there is no request activity within a specific time interval in CICS for this MUF, MUF severs the connection. The MUF startup option of X_EOJ_OK_S_DELAY determines this interval. This feature is not supported in DB 12.0.

EXEMPT TRANS=

A list of up to ten transaction IDs which are exempt from the previously shown limit.

LOG=

Has two fields:

First Field (log)

YES

Indicates that CA Datacom CICS Services should write DBOC, DBIC and internal DBKC command responses to the Message Log file.

NO

Indicates that CA Datacom CICS Services should not write DBOC, DBIC and internal DBKC command responses to the Message Log file.

(The specification for this parameter can also be changed through the DBOC LOG= command. For more information, see LOG= Resetting the Log Option for Operational Commands.)

Second Field (inq)

YES

Indicates that inquiry command responses are written to the Message Log file.

NO

Indicates that inquiry command responses are not written to the Message Log file.

MAXURTS=

The maximum number of URTs that can be defined for use by CA Datacom CICS Services.

MSGLOG=

The destination for the logging of DBOC/DBIC messages.

MUF JOBNM=

The job name for this MUF.

(CA Datacom CICS Services does not display a value in this field if no MUF has been connected.)

OPENAPI=

YES specifies that CA Datacom CICS Services TRUES are enabled as API(OPENAPI) and start the execution on an OPEN TCB. In this case, it is the L8 TCB because CA Datacom CICS Services programs run with EXECKEY=CICS.

NO specifies that CA Datacom CICS Services TRUEs are enabled as API(CICSSAPI). The CA Datacom CICS Services programs run on the same TCB as the calling program runs, and that could mean a QR TCB or an OPEN TCB.

Important! Take caution in setting the proper value. Monitor and measure the system performance to adjust the value appropriately.

The MAXOPENTCBS system initialization parameter controls the number of open TCBs permitted for this purpose. The factors that determine this value include the total sum of the number of USERS defined in the DBCVTPR macro for all connections. This is in addition to the OTE TCB requirements for other applications that are running in the same CICS region. For more information, see the IBM CICS System Definition Guide.

Valid Entries:

YES, NO

Default Value:

No

OPERID=

Ten user IDs with authorization to initiate operational commands for controlling CA Datacom CICS Services such as STARTUP/SHUTDOWN and resources such as URTs and MUFs.

OPSYS=

The operating system in use.

PLANSWI=

YES specifies that dynamic plan selection is used. NO specifies that dynamic plan selection is not used.

PREFIX=

The prefix used for URT names.

REQTHD=

The maximum number of CA Datacom/DB requests permitted in any unit of work. If any task (not found on the exempt list) issues more than this number of CA Datacom/DB requests, it abends with abend code DC18.

If 00000 is displayed in this field, there is no limit on the number of CA Datacom/DB requests that can be issued in any single unit of work.

SCROLL=

Indicates the scrolling method for the display of DBOC/DBIC responses (except INQ=TRACE).

AUTO

CA Datacom CICS Services automatically pages forward after the displayed number of seconds.

MANUAL

Press Enter to scroll forward.

SKIPURT=

Indicates whether CA Datacom CICS Services is to ignore closed URTs when searching for a URT to satisfy a CA Datacom/DB request.

SUB id=

The SVC sub-ID number for this MUF.

SYSVIEW=

Indicates whether CA SYSVIEW is supported.

Note: In z/OS environments, only use the SYSV= parameter to specify CA SYSVIEW as YES in z/OS environments. In z/VSE environments, SYSV= is allowed to default to NO.

TARGET SUBID=

In z/VSE environments, specifies the SUBID of the MUF to which requests are sent. The CA Datacom/DB interface executing in the application region to establish communication with the correct MUF uses this parameter. This value must match the SUBID parameter value of the MUF.

Note: For more information, see VMSUBID= in the CA Datacom/DB Database and System Administration Guide.

TRACE=

Indicates whether the Trace Facility is initiated and the maximum number of entries to be held at one time in the CA Datacom/DB Online Trace Table.

USERID=

Indicates the format of the USER identification that is passed to CA Datacom/DB with each request.

When external security is used, specifying USERID=NO forces CA Datacom/DB to use the 3-byte operator ID (CICS OPERID) instead of the 8-byte user ID (CICS USERID).

In a RACF environment, USERID=NO means that CA Datacom/DB uses the 3-byte operator ID, not the group ID, to secure the database.

Specify USERID=YES to force CA Datacom/DB to use the 8-byte CICS USERID.

USERS=

The maximum number of concurrent CICS users of the database (users with transactions physically waiting on a read event or with requests with exclusive control, that is to say adds, writes, and reads for update).

Note: In a multiple MUF environment, this field shows the value associated with the default MUF. This is the first MUF defined by a DBCSID macro in the DBCVTPR module.

VMID=

In z/VSE environments, specifies the name of the Virtual Machine in which the MUF is executing. This parameter is used in z/VM cross-machine communication. If this parameter is not coded, it is assumed that all applications making requests to the MUF are executing in the same Virtual Machine.

Note: For more information, see VMID= in the CA Datacom/DB Database and System Administration Guide.