LINK

Syntax

ibmCics.link (new LinkOptions()
  .program(<Program>)
  [.commArea(<CommArea>)]
  [.dataLength(<DataLength>)]
  [.inputMsg(<InputMsg>)]
  [.inputMsgLen(<InputMsgLen>)]
  [.noHandle(true)]
  [.channel(<Channel>)]
  [.systemId(<SystemId>)]
  [.syncOnReturn(true)]
  [.retCode(<RetCode>)]
);

Parameters

<Program>

The program to link.

<CommArea>

The communication area to pass to linked program.

<DataLength>

The length of the communication area.

<InputMsg>

The input message to be sent to the invoked program.

<InputMsgLen>

The length of the input message.

noHandle

Optional Boolean. If set to true, exceptions created by this command will be ignored.

<Channel>

The name of the channel made available to the linked program.

<SystemID>

The system name of the linked program.

syncOnReturn

Optional Boolean. If set to true, the system set in SystemID is requested to take a sync point after the program finishes successfully.

<RetCode>

The structure variable to receive the return code from the LINK command. The variable is a structure containing the following five 1-word fields: eibresp, eibresp2, abcode, msglen and msgptr.

Examples

EXEC CICS
    LINK
        PROGRAM('MMIN2010')
        COMMAREA(NEXT-INVOICE-NUMBER)
END-EXEC.

ibmCics.link(new LinkOptions()
  .program("MMIN2010")
  .commArea(locDef.next_Invoice_Number)
);