SETDEF subcommand — set defaults

ASID(X‘0000’) and CPU(0) are the IPCS-defined defaults.

• Deleting a problem
• Dissociating and scratching a data set
• Modifying a data set's attributes, if the data set is associated with more than one problem
• Accessing summary dump data during dump initialization

NOCONFIRM does not request your confirmation before running these subcommands. When NOCONFIRM is specified, IPCS uses summary dump data.

CONFIRM is the IPCS-defined default.

ACTIVE, MAIN, or STORAGE specifies the central storage for the address space in which IPCS is currently running and allows you to access that active storage as the dump source. You can access private storage and any common storage accessible by an unauthorized program.

If IPCS is running as an MVS™ system migration aid, IPCS rejects these parameters.

IPCS does not create a storage map when this parameter is entered. IPCS does maintain a symbol table but limits its automatic creation of symbols into the table.

DSNAME or DATASET specifies the source with the name of a cataloged data set. If the data set is password protected, also specify the password. If you omit the password and it is required, IPCS prompts you for it.

IPCS dynamically allocates and opens the data set when it is first accessed. When an IPCS session completes, IPCS dynamically closes and releases the data set, restoring the data set to its status before being accessed.

FILE or DDNAME specifies the source with the ddname of a data set. The data set can reside on tape or a direct access storage device (DASD). If the data set is password protected, IPCS ignores the password.

NODATASET or NODSNAME specifies that the subcommand is to set the source name in the local or global defaults to a null value. If you do not specify a source, the null value remains in effect.

DISPLAY(MACHINE REMARK REQUEST STORAGE SYMBOL ALIGN)

DISPLAY, entered with one or more display-options, selects parts of a source to be displayed.

NODISPLAY, entered alone, is the same as DISPLAY(REQUEST). It is equivalent to entering:

DISPLAY(NOMACHINE NOREMARK REQUEST NOSTORAGE NOSYMBOL NOALIGN)

DISPLAY(NOMACHINE REMARK REQUEST NOSTORAGE SYMBOL ALIGN) are the IPCS-defined defaults.

 { DISPLAY   } [ ( MACHINE | NOMACHINE ) ]
 { NODISPLAY }
               [ ( REMARK | NOREMARK ) ]
               [ ( REQUEST | NOREQUEST ) ]
               [ ( STORAGE | NOSTORAGE ) ]
               [ ( SYMBOL | NOSYMBOL ) ]
               [ ( ALIGN | NOALIGN ) ]

• Messages produced by IPCS services during the production of a report, but are not part of the report itself. For example, you can suppress the following message with FLAG(TERMINATING):

  BLS22020I ASCBASCB not equal C'ASCB'

  Although FLAG can make a report easier to read, it may eliminate useful information. For example, message BLS22020I may help you to understand why a report does not contain information you expected and may help you locate a storage overlay condition that requires further analysis.

• Messages produced by an IPCS CLIST or REXX exec. For example, you can suppress the following message:

  BLS18104I Symbol xxx not found

  Again, FLAG can make a report easier to read, but it may eliminate useful information. The author of a CLIST or REXX exec may use FLAG on FIND and NOTE subcommands to make message suppression and transmission conditional.

Messages that do not detract from the legibility of a report are generally not affected by the FLAG value.

              FLAG  { (ERROR)            }
                    { (INFORMATIONAL)    }
                    { (SERIOUS | SEVERE) }
                    { (TERMINATING)      }
                    { (WARNING)          }

NOPRINT suppresses sending output to the print data set. NOPRINT is the IPCS-defined default.

NOPDS suppresses sending output to the PDS.NOPDS is the IPCS-defined default.

TERMINAL sends the subcommand's output to your terminal in an interactive IPCS session and to the TSO/E SYSTSPRT data set if IPCS is being run in a batch job.

NOTERMINAL suppresses sending output. However, if NOPRINT is also in effect, all IPCS subcommands, except the SUMMARY subcommand, override the NOTERMINAL option and send their output as if the TERMINAL option had been specified. NOTERMINAL is the IPCS-defined default.

See Table 1 for a summary of the output possibilities.

If you anticipate an abnormal ending while testing a new exit routine written to function in the environment provided by the ASCBEXIT, TCBEXIT, or VERBEXIT subcommands and you want to use TSO/E TEST facilities to isolate the cause of any problems, you should specify the TEST parameter. When TEST is in effect, IPCS allows the TMP, the TSO/E TEST ESTAI functions, or both, to gain control when an abnormal ending occurs.

TEST mode also activates error-detection functions that have been developed to isolate dump data examination problems. Detected errors cause IPCS to abend, so that problems may be trapped close to the point of error.

NOTEST places IPCS in the production mode of operation. Automatic error recovery is attempted should errors occur in the IPCS environment.

When the NOTEST parameter is in effect, IPCS automatically recovers from most abnormal endings without permitting TSO/E TEST to gain control. NOTEST is the IPCS-defined default.

VERIFY specifies that subcommands should produce output and send it. VERIFY is the IPCS-defined default.

NOVERIFY specifies that subsequent subcommands are not to produce output or send it anywhere, regardless of the PRINT and TERMINAL parameters.