Transfers program control.

Sintaxe:

Nota:

The LENGTH option is required with C or C++ programs when COMMAREA is used.

Descrição:

XCTL transfers control from one application program to another at the same logical level. The program from which control is transferred is released; the program to which control is transferred is loaded. The XCTL command cannot be used to call programs in any language other than COBOL, C, C++, or PL/I.

Opções:

COMMAREA(data-area)
• Specifies a communication area that is to be made available to the invoked program.
• In this option, a pointer to the data area is passed after first making a copy of the area if required.
• In a COBOL receiving program, you must give this data area the name DFHCOMMAREA.
• See the TXSeries for Multiplatforms Application Programming Guide.

LENGTH(data-value)
• Specifies, as a 16-bit binary value, the length, in bytes, of the communication area.
• If a negative value is supplied, zero is assumed.
• See LENGTH for more information about using this option.

INPUTMSG(data-area)
• Specifies data that is to be passed to the invoked program when it first issues a RECEIVE command.
• If the invoked program passes control to another program by a LINK command, a linked chain is created, as described under the INPUTMSG option of the LINK command.
• The INPUTMSG data remains available until a RECEIVE command is issued or until control returns to CICS.
• See the TXSeries for Multiplatforms Application Programming Guide for more information about the INPUTMSG option.

INPUTMSGLEN(data-value)
• Specifies a halfword binary value that specifies the length of the data that is passed by INPUTMSG.

PROGRAM(name)
• Specifies the name of the program to which control is to be transferred unconditionally.
• The name can consist of up to eight alphanumeric characters, and must be defined in the Program Definitions (PD) as a local program.

Condições:

NOTAUTH
• Occurs if a resource security check has failed on PROGRAM(name).
• Ação pré-definida: Terminates the task abnormally.

PGMIDERR
• Occurs for the following conditions:
  • The program has no entry in the PD.
  • The program is defined as remote.
  • The program is disabled.
  • The program could not be loaded because:
    • This was the first load of the program and the program load failed.
    • This is usually because the load module could not be found.
    • This was a subsequent load of the program, but the first load failed.
• Ação pré-definida: Terminates the task abnormally.

Informações relacionadas:

• LINK
• TXSeries for Multiplatforms Application Programming Guide
• TXSeries for Multiplatforms Administration Reference