Syzygy Incorporated SyzCMD/z Version 8 [Version 8.8.0] December 23, 2019 [Installation and User’s Guide] Complete on-demand script based system automation facility SyzCMD/z - Installation and User’s Guide Page i SyzCMD/z Version 8 Revision History Version Date Revision Description 8.8 12/23/2019 Major change to IF DOW to allow multiple days and also changed the operand that allows the week that the day falls into to be specified, (i.e. -first SUNday, -second Tuesday , etc.) Added most of the known world-wide SMS text addresses for most (but probably not all) Cell providers. Added support for checking that SyzEMAIL/z is active before any email that might require special processing (i.e. that uses email groups, etc.) to be created. 8.7 2/19/2018 Added ability to check if tape drives are online or offline as well as the ability to check what VOLSER is mounted on the tape drive(s) Added the ability to pause the execution of a script via an operator command “F TASKNAME,HOLD” or “F TASKNAME,PAUSE”, where TASKNAME is the name of the JOB or the TASKID of the STC that is running the script. Once HELD, the task will issue a WTOR asking to reply “GO” when ready to continue. The task will remain paused until either “GO”, “STOP” or “KILL” is received. Go continues the task where it left off, STOP will end the task when the current command completes (but will cause a CC=12). “KILL” will end the task before the next command script command is accepted, and will cause the task to end with CC=99. Added the ability to stop the script task at any time via “F TASKNAME,STOP”. This will allow the current command to complete and will stop the task before the next command is read from the script. The task will receive a CC=12 step code. Added the ability to KILL the script at any time via “F TASKNAME,KILL”. This will immediately KILL the script before the next script command is executed. The task will receive a CC=99. If a task is in “HOLD” status, (i.e. the operator issued a “F TASKNAME,HOLD”, you can “stack” other commands into the buffer. Currently only “HOLD”, “KILL” and “STOP” may be stacked. Added LOOPCHK and LOOPCHEKC command. This command turns of the default GOTO loop checking within a script. This frees the site from the necessity to use “GOTO ++RESET” when creating a loop within the script on purpose. Added new parameter to the PAUSE command of “LONG or FOREVER”. Either sub-parameter will issue a WTOR to the console SyzCMD/z - Installation and User’s Guide Page ii SyzCMD/z Version 8 and PAUSE the script until the WTOR is replied to. Replies can be “GO” to continue, or “STOP” or “QUIT” to end the script. To skip to the “next day” in a script, you can now PAUSE UNTIL 24:00, which will (just) AFTER midnight local time. You can do this any number of times to skip a day each time. Fixed a problem where if the site didn’t include a //INTRDR DD card that a SUBMIT command would fail and get a S0c1 because the INTRDR was not open. The new code will dynamically add the DD if not provided in the task’s JCL 8.6.1 08/15/2017 Add ability to dynamically change the STC TASKID (STCID) to make it easier to deal with multiple SyzCMD/z tasks running at the same time. It can also be displayed via &STCID Added &SCRDSN which shows the dataset that the script was being executed from (or inline of DD *) Added &SCRALL which shows the dataset and member name of the script, (or INLINE if DD *) Fixed &SCRIPT to show the member name (or INLINE if DD *) Added INTerruptible option to PAUSE command to allow all pauses (both UNTIL and for an amount of time) to be SKIPped or to allow the script to be STOPped during the pause. All variables can be used in IF statements. i.e. instead of IFTASKNAME = CICS001 you could use IF &TASKANME = CICS001 Any variable (valid variables start with ampersand, “&”), can be used in this way. The email related TO: and FROM: commands have been changed so that they can be used both within and outside of the EMAIL portion of a script. You can compare and set them before (or during) the email creation. Previously, they could not be used unless you actually had started to generate the email in the script. BEFORE and AFTER no longer require leading zero for times before 10am, i.e. BEFORE 09:00 can be used as BEFORE 9:00. TASKTYPE is now an alias of MYTYPE or TYPE to make using the command easier (to understand). When a log file (files that can be used to write data to during script execution) is opened and closed, the dataset name is displayed as well as the number of lines/records added to the dataset. It was noticed that SyzCMD/z sometimes executes so fast that the times of the consequences of the commands can be before SyzCMD/z - Installation and User’s Guide Page iii SyzCMD/z Version 8 the command appears to have been issued. Timings will no longer be rounded for some items, and the actual time will be kept (internally) to 4 decimals HH:MM:SS.nnnn If a script ends without reaching an ENDIF command, the return code is set to “4” to denote a low impact script programming error. 8.6 12/17/2016 Version 8.6 adds support for console message monitoring. This feature is not meant to replace the much more comprehensive console message monitoring features of SyzMPF/z, but it does allow the SyzCMD/z scripts the ability to interactively process all of the console messages generated while the script is running. New Internal Commands in 8.6: • MSGSTR – allows scanning of all console/syslog messages to find a specific (case sensitive) “string” within that message. There are controls to scan the ENTIRE message or simply beginning in a specific column of the console/syslog message. At the completion of this command the first 50 words of the message found are available as variables within the script and can be used at any time. • MSGWORDS – allows scanning of all console/syslog messages to find a specific set of words (up to 6 case sensitive words) within the console/syslog message. The words may appear in any order, but all words identified MUST appear somewhere in the message. At the completion of this command the first 50 words of the message found are available as variables within the script and can be used at any time. • MSGWORD – same as MSGWORDS except that it looks for a specific Message text (case sensitive) word in a specific place within the message, i.e. a message that the third word is ‘FRED’. At the completion of this command the first 50 words of the message found are available as variables within the script and can be used at any time. The same word position can be checked for multiple alternate words (up to 6). • IFSTR – (If String) Works the same as MSGSTR (above), but allows the use of the IF/THEN/ELSE logic of the SyzCMD/z scripts. At the completion of this command the first 50 words of the message found are available as variables within the script and can be used at any time. • IFWORDS – (If WORDS) works the same as MSGWORDS (above), but allows the use of IF/THEN/ELSE logic of the SyzCMD/z scripts. At the completion of this command the first 50 words of the message found are available as variables within the script and can be used at any time. • IFWORD – If individual WORD) works the same as MSGWORD (above), but allows the use of IF/THEN/ELSE logic of the SyzCMD/z scripts. At the completion of this SyzCMD/z - Installation and User’s Guide Page iv SyzCMD/z Version 8 command the first 50 words of the message found are available as variables within the script and can be used at any time. The same word position can be checked for multiple alternate words (up to 6). • ACTCONS – Activates an internal console of the specified name (as a parm of this command), so that SyzCMD/z can monitor the generated messages for use by the above new commands. • DEACTIVATE CONSOLE – deactivates the console that was activated via the (above) ACTCONS command. • &W0-49 – variables that are filled with the first 50 words of the console message located via one of the new console message processing commands. Words are numbered relative to zero (being the first word). &W0 is normally the message number for “normal” messages, operator commands that are scanned will not normally have message numbers so &W0 will be the first word they typed at the console. • &WORD variable is set to the word in the Message that matched the requested position within the message and is set by the “IF WORD” and “MSG WORD” command requests. • &STR and &STRING variables are set to the string that matched the requested position within the message processed and is set by the “IF STR” IF STRING” “MSG STR” and “MSG STRING” command requests. • The PAUSE command has been enhanced to allow the generated information message on the task waiting to be “other” then the default HIGHLIGHTED. It can be Low or not displayed at all with the new feature.