Skip to content

Monitoring the ChangeMan ZMF Promotion Scheduler

The Promotion Scheduler function allows the user to display a list of packages to be promoted under the control of the ChangeMan ZMF internal scheduler. This function can be used to suspend, push back, or push up a package's promotion date.

Select option 3 to monitor the ChangeMan ZMF Promotion Scheduler:

CMNMONIT                             Monitor Options 
Option ===> __________________________________________________________________

1  Limbo Packages in limbo
2  Install CMN installation scheduler
3  Promotion CMN promotion scheduler
4  All All packages

Enter the package in question, in this case all CISQ packages:

CMNMISCH                 Monitor PROMOTION Scheduler - Part 1 of 2 
Command ===>  ________________________________________________________________

Specify selection criteria: 
Package . . . . . . . . . . CISQ\*      (Full name, pattern, blank or \*) 
Install date: from . . . . ________     (yyyymmdd) 
              to . . . . . ________     (yyyymmdd)

There is one CISQ package, CISQ000029.

CMNMISC2 --------- Monitor PROMOTION Scheduler - PART 2 OF 2 - Row 1 to 1 of 1 
Command ===> ________________________________________________ Scroll ===> CSR

    Package     Date        Time    Type        Request     Status
  _ CISQ000029  20081230    1200
**************************** Bottom of data ******************************

Similar to the Installation scheduler, the following Line commands can be entered:

  • H Causes the submission of a package's install job to be suspended. It will remain so until a subsequent R command is issued. When the internal scheduler reviews the list, this package will be bypassed.

  • R Releases an install job that had been previously held in the CMN scheduler.

  • C Allows the user to change the package's install/promotion date.

  • D Allows the user to delete an individual package from the scheduler. The status field is flagged with the *DELETE message.

  • S May only be issued against temporary packages. It submits the deinstall job prior to the temporary change duration being met. This feature is available in the installation scheduler only.

Attaching and Detaching TCP/IP Connections

If TCP/IP comes down while ChangeMan ZMF is up, any users connected via TCP/IP cannot sign back on. The following operator commands allow for recovery from a TCP/IP outage. They also provides the means for:

  • Gracefully shutting down all TCP/IP connected users while not interrupting crossmemory connected users.

  • Forcefully shutting down all TCP/IP connected users without impacting cross-memory connected users. This function is able to execute even in case of a complete TCP/IP failure.

  • Re-initializing the API (and subsequent re-logon of TCP/IP users), optionally providing the name of an alternate TCP/IP (stack).

There are three operator commands for TCP/IP are STOP, START, and RESTART:

TCPIP,STOP,[mins]

This command will display the current users that are connected by ports.

If no interval ([mins]) is specified, 0 minutes are assumed.

As soon as the command has been entered, no further TCP/IP connections are accepted.

A warning will be issued to all TCP/IP connected users every minute up to [mins] minutes, after which the TCP/IP users are terminated.

Refer to the SYSLOG and SERPRINT to see the results of these commands. Messages and message formats change, The following screen scrapes were current when this document was written, and are provided as a reference.

...

NC0000000 C001 2008188 11:28:50.97 USER25   00000280 F SERT3TMP,TCPIP,STOP
N FFDF000 C001 2008188 11:28:51.28 S0466400 00000080 SER0916I TCPIP Stop Requested  
N FFDF000 C001 2008188 11:28:51.28 S0466400 00000080 SER0920I Current Users:0 Maximum Users:32767
N FFDF000 C001 2008188 11:28:51.28 S0466400 00000080 SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><PartnerIdentifier>
S                                                             Users=0  
N FFDF000 C001 2008188 11:28:51.28 S0466400 00000080 SER2012I XCH No active users found  
N FFDF000 C001 2008188 11:28:51.30 S0466400 00000080 SER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><PartnerIdentifier>
S                                                             Users=0  
N FFDF000 C001 2008188 11:28:51.30 S0466400 00000080 SER2012I CMN No active users found  

ISFPCU41 UT DISPLAY SERT3TMP S0466400 DSID      2 LINE 50       COLUMNS 02- 161   
 COMMAND INPUT ===>                                             SCROLL ===> PAGE  
11.28.51 S0466400 SER0916I TCPIP Stop Requested  
11.28.51 S0466400 SER0920I Current Users:0 Maximum Users:32767  
11.28.51 S0466400 SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><PartnerIdentifier> Users=0
11.28.51 S0466400 SER2012I XCH No active users found  
11.28.51 S0466400 SER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><PartnerIdentifier> Users=0
11.28.51 S0466400 SER2012I CMN No active users found

TCPIP,START,[name]

This command will start TCP/IP communications (INITAPI) provided that the TCP/IP API has not already been initialized.

If the second parameter ([name]) IS specified, this TCP/IP STC stack name is used when initializing the TCP/IP environment.

When [name] has not been specified connection is made to the default TCP/IP stack, or leaves the selection up to the TCP/IP code which parses the SYSTCPD DD statement.

...

N FFDF000 C001      2008188 11:30:52.71 S0466400 00000080 SER0915I TCPIP Start Requested
N FFDF000 C001      2008188 11:30:52.78 S0466400 00000080 SER1000I CMNSTART TCP/IP environment active at 10.35.11.100..6031
N FFDF000 C001      2008188 11:30:52.78 S0466400 00000080 SER1001I CMNSTART TCP/IP local host name: C001

11.30.52 S0466400   SER0915I TCPIP Start Requested
11.30.52 S0466400   SER1000I CMNSTART TCP/IP environment active at 10.35.11.100..6031 
11.30.52 S0466400   SER1001I CMNSTART TCP/IP local host name: C001

TCPIP,RESTART,[mins],[name]

The RESTART command will display the active TCP/IP users and stop accepting TCP/IP connection requests. It is combination of the STOP and START command and will behave exactly as if the STOP and START commands had been issued one after the other.

The (optional) parameter [mins] defines how long to allow for a voluntary logoff of the TCP/IP connected users. A warning will be issued to all TCP/IP connected users every minute up to [mins] minutes, after which the TCP/IP users are terminated.

An optional TCP/IP STC name [name] may be specified, overriding the TCP/IP default.

The individual usage of STOP and START commands allows the customer to recycle his TCP/IP ST3. Before doing so, the existing TCP/IP users can be gracefully disconnected by using the TCPIP STOP command.

The second RESTART format, that is, with [name] specified, is most useful when the customer wishes to switch TCP/IP stacks by specifying the optional name parameter.

...

NC0000000 C001 2008188 11:42:22.36 USER25   00000280 F SERT3TMP,TCPIP,RESTART  
N FFDF000 C001 2008188 11:42:22.55 S0468486 00000080 SER0917I TCPIP Restart Requested  
N FFDF000 C001 2008188 11:42:22.55 S0468486 00000080 SER0920I Current Users:0 Maximum Users:32767  
N FFDF000 C001 2008188 11:42:22.55 S0468486 00000080 SER2010I XCH ###\<User_ID\>\<T_Elapsed\>\<T_LastAct\>\<Partner Identifier\> 
S                                                    Users=0  
N FFDF000 C001 2008188 11:42:22.55 S0468486 00000080 SER2012I XCH No active users found  
N FFDF000 C001 2008188 11:42:22.57 S0468486 00000080 SER2010I CMN ###\<User_ID\>\<T_Elapsed\>\<T_LastAct\>\<Partner Identifier\> 
S                                                    Users=0  
N FFDF000 C001 2008188 11:42:22.57 S0468486 00000080 SER2012I CMN No active users found  
N FFDF000 C001 2008188 11:42:22.65 S0468486 00000080 SER1000I XCH TCP/IP environment active at 10.35.11.100..6032 
N FFDF000 C001 2008188 11:42:22.65 S0468486 00000080 SER1001I XCH TCP/IP local host name: C001  

ISFPCU41 UT DISPLAY SERT3TMP S0468486 DSID  2 LINE 38   COLUMNS 02- 161   
 COMMAND INPUT ===>                                     SCROLL ===> PAGE  
11.42.22 S0468486 SER0917I TCPIP Restart Requested  
11.42.22 S0468486 SER0920I Current Users:0 Maximum Users:32767  
11.42.22 S0468486 SER2010I XCH ###\<User_ID\>\<T_Elapsed\>\<T_LastAct\>\<Partner Identifier\> Users=0 
11.42.22 S0468486 SER2012I XCH No active users found  
11.42.22 S0468486 SER2010I CMN ###\<User_ID\>\<T_Elapsed\>\<T_LastAct\>\<Partner Identifier\> Users=0  
11.42.22 S0468486 SER2012I CMN No active users found  
11.42.22 S0468486 SER1000I XCH TCP/IP environment active at 10.35.11.100..6032  
11.42.22 S0468486 SER1001I XCH TCP/IP local host name: C001

...