z/OS V1R9.0 TSO/E Command Reference

CALL Commandis to support the execution of programs written for a batch processingenvironment rather than a TSO/E environment.ASIS | CAPSCALL command return codesASISprevents translation of a parameter list to uppercase characters. Use ASISfor programs that accept mixed case characters in a parameter list; theCALL command will not alter the parameters in any way when the ASISoption is specified.CAPStranslates the parameter list to uppercase characters. CAPS is the default.PASSENVB | NOENVBPASSENVBpasses the currently active REXX environment block (ENVBLOCK) addressto the invoked program in register 0. The currently active REXXENVBLOCK is obtained from the environment to which the CALL commandis directed. See “Example 6” on page 73 and “Example 7” on page 73 foruses of PASSENVB in REXX execs. This operand is:v recognized for unauthorized programs and non-isolated environmentsv ignored for authorized programs and isolated environments.For a description of isolated environments, refer to z/OS TSO/EProgramming Services. For further information about the REXXenvironment block refer to z/OS TSO/E REXX Reference.NOENVBdoes not pass a REXX environment block (ENVBLOCK) address. Thecontents of register 0 on entry to the invoked program are unpredictable.NOENVB is the default.Table 7. CALL command return codes0 Processing successful.12 Processing unsuccessful. An error message has been issued.Other Return code is from the called program.CALL command examplesExample 1Operation: Start a load module.Known:v The name of the load module: JUDAL.PEARL.LOAD(TEMPNAME)v Parameters: 10,18,23call pearl ’10,18,23’Example 2Operation: Start a load module.Known:v The name of the load module: JUDAL.MYLIB.LOAD(COS1)call mylib(cos1)72 z/OS V1R9.0 TSO/E Command Reference