Communications › Standard CA Datacom/DB Call

Standard CA Datacom/DB Call

If an application needs to issue a CA Datacom CICS Services command, the simplest method is to use the CA Datacom/DB Request Area. This method does not return a response or produce output. It does provide a special return code with limited meaning in the CA Datacom/DB Request Area. Any response from CA Datacom CICS Services which would normally appear on a terminal is written only to the Message Log file (DBOC). The failure or success of the command is not returned to the issuing application.

Procedure

Use the following procedure to issue a CA Datacom CICS Services transaction with a CA Datacom/DB call.

1. Place DBOC in the command field of the Request Area. It is presumed that the command field is set to DBOC. No validation of the field is done by CA Datacom CICS Services.
2. Place the length (in hexadecimal) of the command text in the first two bytes of the Work Area, followed by the command text beginning with the transaction ID followed by a space. The wildcard character ? (a question mark) is not supported in this mode.

Example Work Area

In the following example, DBOC CLOSE=nnnn is the CA Datacom CICS Services command (character) and the nn (in nnDBOC) is the length of command text (hexadecimal).

 ----+----1----+----2----+----3----+----4----+----5----+----6

 nnDBOC CLOSE=nnnn

If the DISCONNECT, CONNECT, and IMMEDIATE commands are used, they must be coded exactly as shown following:

• nnDBOC DISCONNECT=mm where nn is X'0014' or greater and mm is the MUF number
• nnDBOC CONNECT=mm where nn is X'0011' or greater and mm is the MUF number
• nnDBOC IMMEDIATE=mm where nn is X'0013' or greater and mm is the MUF number.