Abend-AID SVC51 Interface Installation Utility (CWINSTAL)

With the CWINSTAL utility, you start and stop Abend-AID and perform various other functions related to the Abend-AID SVC51 interface. The JCL required to execute CWINSTAL can be found in member $12INSTL in the Abend-AID installation library hlq.CTL.

All Abend-AID diagnostics, including those for LEAID and SNAP-AID processing, require the use of the Abend-AID SVC51 interface.

The SVC51 interface operates in production mode only, in test mode only, or in both production and test modes simultaneously. Only one production SVC51 interface and/or one test SVC51 interface can be in operation at a time. If Abend-AID is to be started in both production and test modes, the production SVC51 interface must be started first and the test SVC51 interface must be started second. This enables the test SVC51 interface to gain control first and perform its job name evaluation. If the job name does not match a CWINSTAL TEST parameter job name mask, then control is passed to the production SVC51 interface.

You start Abend-AID production mode, which diagnoses failures in all jobs, by executing CWINSTAL without specifying a parameter. You start test mode, which diagnoses failures in specified jobs, with the TEST parameter. Invoke other functions with the parameters listed below. Messages generated from CWINSTAL appear in the job log.

CWINSTAL syntax

Parameters

LIST

Displays the status of the Abend-AID SVC51 interface (the releases started and other pertinent status information).

TEST,jobname

Starts a test version of Abend-AID for selected jobs. The production version of Abend-AID does not need to be stopped and restarted in order to start a test version of Abend-AID.

The jobname subparameter specifies either an actual job name or job name mask. A string of multiple job names and/or job name masks separated by commas can be entered. The string can be 1 to 95 characters. When specifying a job name mask, do not include a wildcard or special character. Only specify these characters if they are actually used in the job names at your site.

Examples

All jobs that have job name NEWAATST or job names that begin with the characters ABC will utilize the test Abend-AID interface:

PARM=’TEST,NEWAATST,ABC’

To continue a string of multiple job names onto another statement, enclose the expression in parentheses. End each statement with a comma after a complete jobname subparameter and begin the second line in column 16, as shown below:

//AADYNAM EXEC PGM=CWINSTAL,PARM=(TEST,ABCDEF,GHI,
//             XYZ)

STOP

Stops the production version of the Abend-AID interface.

STOP,*

Stops the test version of the Abend-AID interface that was started using the TEST,jobname parameter.

AJOB,jobname

Add the specified job names or job name masks to an active test Abend-AID interface.

DJOB,jobname

Delete the specified job names or job name masks from an active test Abend-AID interface.

Examples

Adds the job name mask DEF to the list of jobs that utilize the test Abend-AID interface: 

Deletes job name NEWAATST from the list of jobs that utilize the test Abend-AID interface:

APF-Authorization Considerations

The Abend-AID and Abend-AID Common Components authorized load libraries (SPAAAUTH and SKAZAUTH) must be APF-authorized. They were allocated during the SMP/E install.

If the Abend-AID authorized load library (SPAAAUTH) containing modules CWINSTAL and ABENDAID is authorized only because it is on the link list and not in the APF list, authorization will be lost when the load library is accessed via a //JOBLIB, //STEPLIB, and/or //ABENDLIB DD statements.

Zap for Uppercase Messages

CWINSTAL’s messages are in mixed case. To get uppercase output, zap the character at CSECT UPCASE to change it from N to Y. Use the following AMASPZAP control cards to produce uppercase output: