z/OS V1R9.0 TSO/E Command Reference

CALL CommandCALL command syntaxNote: Allocating the input file to a terminal results in an I/O error message.Abnormal termination occurs when the program tries to get input from theterminal.►►CALL*dsname (member_name) 'parameter_string'CAPSASIS►►NOENVBPASSENVB►◄CALL command operandsdsnamespecifies the name of a PDS or a PDSE from which the program is to beexecuted. If dsname is not fully qualified, it is assumed to be’prefix.dsname.LOAD’.* specifies that CALL should use the standard load module search sequence forthe member name.(member_name)specifies the program name to be executed. When you specify only amember_name, the fully—qualified dsname and member_name, it is assumedto be ’prefix.LOAD(member_name)’. If member_name, is not specified, themember ’TEMPNAME’ is assumed.Note: CALL command processing allocates the data set you specify and thenaccesses the member:1. When allocating the data set, it is possible that the cataloged versionof the data set will not be used, but rather a different copy that hasalready been allocated in your TSO/E session. For information abouthow MVS dynamic allocation may convert an existing allocation, referto z/OS MVS Programming: Authorized Assembler Services Guide.2. When giving control to the program, the data set you specify on theCALL command is established as a task library. The tasklib iseffective for the execution of the CALL command.parameter_stringspecifies up to 100 characters of information that you want to pass to theprogram as a parameter string. The character string can contain DBCScharacters that you delimit with shift-out (X'0E') and shift-in (X'0F') characters.The program to be executed receives parameters according to the standardlinkage conventions. These are the same conventions that will apply if theprogram was executed by batch job control language (JCL) and a parameterstring was passed by the EXEC statement with the PARM keyword.Some utilities accept multiple entry parameter lists; for example, to pass a list ofalternate ddnames, TSO/E commands require a special multiple entryparameter list known as a command processor parameter list (CPPL). Neitherof these options are supported by the CALL command, whose primary purposeChapter 1. TSO/E commands and subcommands 71