How to invoke CICSPlex SM workload management

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.

Related concepts
Requesting additional dynamic routing support
Dynamic routing with CICSPlex SM
Workload management and dynamic routing
Workload requirements
Related tasks
Modifying dynamic routing
Creating a user-replacement module for EYU9WRAM
Related reference
Processing considerations
Sample calling sequence
[[ Contents Previous Page | Next Page Index ]]