As ever, you use this free program at your own risk.
Feel free to use the free software on this site but please honor the copyright.
The program, ASLSUBCM, is a utility program that can be used to issue
start or stop commands for a subsystem. As written, it will start or stop a
DB2 or MQ subsystem.
ASLSUBCM is useful if you do not have an automation product available
on the system, or to recycle subsystems outside of automation, if needed.
Even if your shop has automation processes in place this program shows how to
issue a command from a program using SVC 34.
ASLSUBCM also utilizes a multi-line WTO and a WTOR.
The program will search the SSVT for any desired subsystems and determine the state of them (active or inactive). ASLSUBCM will use the subsystem recognition character for start or stop the subsystem.
There are a couple of ways to determine the subsystem action to be taken.
- The first is that the action to be taken can depend upon the first 4 characters of the jobname. If the jobname starts with "STOP" the chosen subsystem will be shutdown. If the jobname starts with "STAR" the chosen subsystem will be start. If ASLSUBCM detects that the chosen subsystem is already in the desired state (or is not defined) no action is taken.
- Using a NOCHECK DD DUMMY card you can bypass the jobname check. If you use the NOCHECK option, you must provide either a STOP DD DUMMY JCL card or a START DD DUMMY JCL card.
As the program issues SVC 34 it must be APF authorized.
Program Limitations
ASLSUBCM has a limit on the number of subsystem names that it can list in the multi-line WTO.
The limit, as coded, is 40. This limit is probably going to be more than enough for a site's needs.
If you need to increase this limit, see the program documentation.
If the target subsystem is a DB2 system then the program should be permitted to issue start and stop commands in the security of DB2.
| Link |
Description | |
|---|---|---|
| This link will take you
to a file that contains the PDF manual for ASLSUBCM.
This manual also contains installation instructions. The manual is also provided in the PDS that is in the XMI file. |
||
|
|
||
| This link will take you to a file that contains the z/OS load library containing the ASLSUBCM program. This file should be unzipped and the TSO transmit file (ASLSUBCM.XMI) should be transferred to the z/OS system using a file transfer program. The file must be transferred as a BINARY file. | ||
|
|
||
| This
link will display program assembly and link information for ASLSUBCM. |
||
|
|
||
Installation Instructions
For installation instructions click the button below.
This material has been used successfully by Abbydale Systems LLC. and to the best of our knowledge this material and any system(s) of which it is a part are operational as of the service level or date stated in the body of this material (if so stated). However, NO warranty is given or implied as to the accuracy of this material or any related material or systems, and no responsibility is assumed for any effect or modification directly or indirectly caused by the use of this material.
It is the responsibility of any user of this material to evaluate its usefulness to the user's environment.
Abbydale Systems LLC. does not guarantee to keep this or any related material current, nor does it guarantee to provide any corrections or extensions described by any users of this material or any corrections or extensions made in the future by Abbydale Systems LLC. itself.
