z/OS V1R9.0 TSO/E Command Reference

TEST CommandIf TEST is specified with a data set name, or *, registers 2 through 12 areinitialized to X’FFFFFFFF’. this allows you to determine which registers havebeen changed by the tested program.When TEST is specified for a load module in a PDS or a program object in aPSDE, the program being tested can invoke other user programs, if they aremembers of the same PDS or PDSE. The services by which one member caninvoke another in the same PDS or PDSE include LINK, LOAD, XCTL, andATTACH.CAUTION: The program to be tested should not have the name TEST orthe name of any existing TSO/E service routine.‘parameters’specifies a list of parameters to be passed to the program being tested. The‘parameters’ are valid only with the NOCP or TP keywords. If you specify theCP operand, the system ignores the parameters. The list must not exceed 100characters, including delimiters.LOAD | OBJECTLOADspecifies the named program is either:v a load module that has been processed by the linkage editor or binderand is a member of a partitioned data set (PDS)v a program object that has been processed by the DFSMS/MVS* binderservice and is a member of a partitioned data set extended (PDSE).If both LOAD and OBJECT are omitted, LOAD is the default.OBJECTspecifies the named program is an object module that has not beenprocessed by the linkage editor or the DFSMS/MVS binder service. Theprogram can be contained in a sequential data set or a member of apartitioned data set.If OBJECT is specified on the TEST command, the tested program will benamed TEMPNAME.CPspecifies the named program is a command processor.NOCPspecifies that the named program is not a command processor. If you do notspecify CP, TP, or NOCP, then NOCP is the default.TP(’tp_name’)specifies that the named program is an inbound APPC/MVS transactionprogram. tp_name specifies the name of the transaction program you want totest. It is case sensitive and required if you specify the TP keyword. Thetp_name can have a length of 1 to 64 characters consisting of uppercase andlowercase letters A–Z, numerals 1–9, and 19 special characters:.?:’=". If tp_name contains an apostrophe, you must enter twosuccessive apostrophes for each single apostrophe.The TEST command does not recognize transaction program alias names. Forexample, if you specify an alias of a transaction program name, it is considereda new transaction program name.LU(’lu_name’) | BASELU284 z/OS V1R9.0 TSO/E Command Reference