|
|
As ever, you use this free program at your own risk.
Feel free to use the 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 don't 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 a site needs.
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.
A document detailing how to use the ASLSUBCM program can be found
here or in the PDS that is received.
| |
| |
| |
Step 1 |
Download The ASLSUBCM Program's XMI file
The ASLSUBCM facility is distributed as a binary XMI file.
Download the XMI file from here.
|
|
| |
| |
| |
Step 2 |
Upload The ASLSUBCM Facility to the Target z/OS System
File transfer the XMI file downloaded in Step 3 up to the target z/OS system as a binary file. The XMI file must be transferred as a binary file otherwise the file will be corrupt.
|
|
| |
| |
| |
Step 1 |
RECEIVE the Transferred File
Issue the TSO RECEIVE command for the file that was transferred to the target system.
RECEIVE your.uploaded.file.XMI
|
|
| |
| |
| |
Step 4 |
Run the UNPACK member of the Received Dataset
The UNPACK member of the received dataset will extract the two datasets that comprise the ASLSUBCM facility.
Follow the prompts issued by the UNPACK member and all the required datasets and a PDF dataset will be allocated and populated with
of the required components.
To execute the UNPACK member either put an EX next to the member i.e.
Executing the UNPACK Member
Menu Functions Confirm Utilities Help
------------------------------------------------------------------------------
EDIT ABBYDALE.ASLSUBCM.PDS Row 00001 of 00013
Command ===> Scroll ===> CSR
Name Prompt Size Created Changed ID
_________ $$$INDEX
_________ $$INSTAL
_________ COPYRITE
_________ DISCLAIM
_________ JCL
_________ LOADLIB
_________ PDF
_________ PROGINFO
_________ README
_________ SOURCE
EX UNPACK
**End** |
Alternatively issue the execute as you would any other REXX exec. i.e.
TSO EX 'your.received.dataset(UNPACK)'
A full description of the members containe din the XMI file can be found here. |
|
| |
| |
| |
Step 5 |
Read the $$INSTAL Member to Complete the Installation
The $$INSTAL member of the received dataset contains instructions of how to complete the installation
of the ASLSUBCM program.
The implementation will differ depending on the site standards but
essentially you need to make the load library available to the users.
|
|
| |
| |
| |
Step 6 |
(Optionally) Download the PDF
To download the PDF file transfer it to a Windows based operating system as a binary file with a .PDF extension.
Once it is on the Windows system it should be able to be read as a PDF.
Alternatively you can download the PDF directly from here.
|
|
|
Click the PDF logo to download the ASLSUBCM PDF |
