Previous Topic: USERS=Next Topic: Sample Assembly JCL for DBCVTPR (z/OS)


Example DBCVTPR Specifications

The following examples illustrate requirements for typical sites:

Example 1

 DBCVTPR USERS=4,MAXURTS=15,AUTO=(2,3),SYSRCV=YES
USERS=4

Specifies in this example a MUF environment in which up to four concurrent requests can be serviced.

MAXURTS=15

Specifies in this example that the highest number assigned to any URT is 0015.

AUTO=(2,3)

Specifies that in this example URTs 0002 and 0003 are opened automatically when first required.

SYSRCV=YES

Specifies that two-phase commit processing be performed.

Example 2

 DBCVTPR MAXURTS=1,PREFIX=AFILE,USERS=2,SYSRCV=YES,EOJ_OK=DISCONNECT
MAXURTS=1

Specifies in this example a MUF environment with a single URT.

PREFIX=AFILE

Specifies that the single URT in this example is named AFILE001.

USERS=2

Specifies that in this example the system can service up to two requests concurrently.

SYSRCV=YES

Specifies that two-phase commit processing be performed.

EOJ_OK=DISCONNECT

Specifies that when CA Datacom CICS Services is actively processing requests and is notified by MUF that an EOJ has been requested, the CA Datacom CICS Services issues a DISCONNECT for the MUF connection. This action allows an orderly end for transaction with exclusive control.

Example 3

 DBCVTPR MAXURTS=20,DEFER=(1,2),SYSRCV=YES,EOJ_OK=IMMEDIATE
MAXURTS=20

Specifies in this example that in this MUF environment the highest numbered URT is 0020 (MAXURTS=20).

DEFER=(1,2)

Specifies that in this example URTs 0001 and 0002 are to remain unopened unless they are opened by the user.

SYSRCV=YES

Specifies that two-phase commit processing be performed.

EOJ_OK=IMMEDIATE

Specifies that when CA Datacom CICS Services is actively processing requests and is notified by MUF that an EOJ has been requested, the CA Datacom CICS Services issues a IMMEDIATE disconnect from the MUF regardless of the state of current transactions.

Example 4

     DBCVTPR MAXURTS=200,AUTO=(21-100),DEFER=(101-200),                 X
                SKIPURT=YES,TRACE=(ON,500),AUXTRCE=(OFF,CLUA,CLUB),     X
                USERS=15,REQTHD=(60000,DB??,AP??),SCROLL=MANUAL,        X
                MSTOPR=(DRK,DBY),MSGLOG=DBLT,LOG=(YES,NO),              X
                SYSV=YES,DBTS=(TEST,DBTX),SYSRCV=YES, OPENAPI=(YES)
MAXURTS=200

Specifies in this example a MUF environment in which there are 200 possible URTs. The first 20 URTs (001—020) are opened at startup.

AUTO=(21-100)

Specifies in this example that the next 80 URTs (021—100) are opened when a task requiring them executes.

DEFER=(101-200)

Specifies in this example that the remaining URTs (101—200) are opened only when explicitly opened with a DBOC OPEN= command.

SKIPURT=YES

Specifies in this example that URTs that are closed and those that are unopened but not marked for AUTO-open are to be skipped when searching for a URT to satisfy a request from CA Datacom/DB.

TRACE=(ON,500)

Specifies in this example that the Trace Facility is running from CA Datacom CICS Services startup with up to 500 entries maintained in the Trace Table.

AUXTRCE=(OFF,CLUA,CLUB)

Specifies in this example that the auxiliary trace is off at startup, and the name of the primary and secondary destinations are CLUA and CLUB.

USERS=15

Specifies in this example that 15 is the maximum number of allowed concurrent CICS users of the database.

REQTHD=(60000,DB??,AP??)

Specifies in this example that any transaction can issue 60,000 CA Datacom/DB requests before CA Datacom CICS Services forces it to abend, but any transaction beginning with a prefix of DB or AP is never forced to abend because of too many CA Datacom/DB requests.

SCROLL=MANUAL

Specifies in this example that the MANUAL method is to be used to control the DBOC and DBIC display paging.

MSTOPR=(DRK,DBY)

Specifies in this example that the master operators are DRK and DBY.

MSGLOG=DBLT

Specifies in this example that DBLT is the destination ID for logging DBOC and DBIC messages. DBOC commands (but not DBOC responses) are to be logged to the file DBLTPRT.

LOG=(YES,NO)

Specifies in this example that responses to DBIC/DBOC commands are to be written to the Message Log file (CSMT), but inquiry command responses are not to be written to the Message Log file.

SYSV=YES

Specifies in this example that the release of CA SYSVIEW that is compatible with this release of CA Datacom CICS Services is supported (in z/OS only) in this CA Datacom CICS Services environment.

DBTS=(TEST,DBTX)

Specifies in this example that TEST is the alternate transaction ID for the CA Datacom CICS Services Test Facility as the replacement ID for DBTS (but DBTX is not replaced).

SYSRCV=YES

Specifies that two-phase commit processing be performed.

OPENAPI=YES

Specifies that CA Datacom CICS Services TRUEs start execution on OPEN TCBs. In this case, it is L8 because they run with EXECKEY=CICS.