To invoke the CICSPlex® SM workload management facilities, use an EXEC CICS® LINK command, specifying EYU9XLOP as the program and identifying EYURWTRA as the communication area. The format of the command is:
EXEC CICS LINK
PROGRAM(EYU9XLOP)
COMMAREA(EYURWTRA)
LENGTH(=AL2(WTRA_LENGTH))
Much of the data normally passed from the CICS relay program to the dynamic routing program in the DFHDYPDS communication area must be generated by your program and passed to CICSPlex SM workload management. Other data that is normally derived by CICSPlex SM workload management from a transaction- and terminal-oriented environment must also be provided by your program. The assembler copy book EYURWTRA provides a map of the communication area to be passed to CICSPlex SM workload management.
The corresponding copy books and the CICSPlex SM libraries in which they can be found are:
Language | Member name | Library |
---|---|---|
Assembler | EYUAWTRA | SEYUMAC |
COBOL | EYULWTRA | SEYUCOB |
PL/1 | EYUPWTRA | SEYUPL1 |
C | EYUCWTRA | SEYUC370 |
Prior to invoking CICSPlex SM workload management, you must initialize the EYURWTRA communication area. The format of EYURWTRA is shown in Figure 55.
For a list of the possible response and reason code values that can be returned in WTRA_API_RESP and WTRA_API_REAS, refer to the assembler copy book member EYURWCOD.