To execute a program in the CICS® region.
LINK >>-LINK--PROGRAM(program_name)--+---------------+---------------> '-,CICS(applid)-' >--+-------------------------------------------------------------------------------------+--> '-,COMMAREA(data)-+----------------+-+--------------------+-+-----------------------+-' '-,LENGTH(value)-' '-,DATALENGTH(value)-' '-,HEXPADCHAR(hex_byte)-' >--+-----------------------------+----------------------------->< '-,NOTACTIVE(-+-CONTINUE--+-)-' '-TERMINATE-'
You can use the LINK command to link to and execute a program in the target CICS region.
Note that the batch request utility does not link directly to the requested program. As with all other commands, the LINK command is passed to a CICS BAC request server, which in turn links to the requested program. Therefore, the linked-to program runs as part of the same EXCI mirror transaction that is running the CICS BAC request server.
The PROGRAM parameter is the only required parameter: all the others are optional.
The data returned from the DPL program is written to the CBKPRINT data set, up to a maximum of 256 bytes.
If you specify a commarea, you can also specify LENGTH, DATALENGTH, and HEXPADCHAR (see below).
You can specify DATALENGTH only if you also specify a COMMAREA with data.
You can specify HEXPADCHAR only if you also specify a COMMAREA with data.
You can specify LENGTH only if you also specify a COMMAREA with data.
If you specify a length less than 256 bytes, it also controls the number of bytes written to the CBKPRINT print data set. If you specify a length greater than 256, only the first 256 bytes are written to the data set