Modify Commands
This appendix describes modify commands that may be issued to a Sernet started task.
These modify commands may be issued from the operator console or through SDSF by authorized users.
Responses to these commands are displayed in the SERPRINT sysout data set of the Sernet instance.
Standard Modify Commands
An application administrator or a console operator may use these modify commands to manage a Sernet started task and the applications that run under it.
ABEND
| Purpose | Abend the started task with an 0C3. |
| Application(s) | All applications running under a Sernet started task. |
| Format | /F jobname,ABEND Where: jobname Started task jobname |
| Comments | Use of this modify command is not recommended without instructions from Micro Focus Customer Care. |
| Examples | /F SERT5,ABEND |
| Response | ASER0850I Operator command: ABENDSER0952W Intentional abend <S0C3> requested |
...
ASIDS
| Purpose | Display the maximum number of concurrent address spaces and time-out minutes. Display the number of address spaces that are running as well as the address space requests that are waiting to run and the classes assigned. |
| Application(s) | All applications running under a Sernet started task |
| Format | /F jobname,ASIDS Where: jobname Started task jobname |
| Comments | The maximum number of address spaces is 256, and the maximum number of time-out minutes is 255, but whatever was input is displayed in SERPRINT. |
| Examples | /F SERT5,ASIDS |
| Response | SER0850I Operator command: ASIDSSER0901I Number of Address Spaces:16 Expiration Timeout:20 MinutesSER0904I 0 active address spaces are running at this time. |
...
ASIDS4R
| Purpose | Dynamically adjusts the ASIDS4RECALL setting. See Appendix D: Sernet Keyword Options for more information. |
| Application(s) | All applications running under a Sernet started task |
| Format | /F jobname,ASIDS4R,nWhere: jobname Started task jobname n Is a numerical value from 2 to 16. |
| Examples | /F jobname,ASIDS4R,8 |
...
ASINITi
| Purpose | For an initiator, modify the maximum number of concurrent address spaces that can be created and the job classes assigned to the initiator. |
| Application(s) | All applications running under a Sernet started task |
| Format | /F jobname, ASINITi=(n,c) Where: jobname - Started task jobname i - Initiator number n - Maximum number of concurrent address spaces c - Job classes |
| Comments | The address space limit is checked when an application needs to start an address space for an asynchronous operation. An example of an asynchronous process that uses a separate address space is ChangeMan ZMF ISPF file tailoring for install JCL. The maximum number of address spaces is 256, but whatever you input is displayed in SERPRINT. |
| Examples | /F SERT5,ASINIT2=(50,ABC) |
| Response | SER0850I Operator command: ASINIT3=(10,ABC)SER0901I Number of Address Spaces:22 Expiration Timeout:25 Minutes SER0902I Initiator:1 Classes:ABCD Maximum:4 Active:0SER0902I Initiator:2 Classes:ABCD Maximum:4 Active:0 SER0902I Initiator:3 Classes:ABC Maximum:10 Active:0SER0902I Initiator:4 Classes:ABCD Maximum:4 Active:0 |
...
ASINITS
| Purpose | For each initiator, display the assigned job classes, the maximum number of concurrent address spaces that can be created, and the number of active address spaces. |
| Application(s) | All applications running under a Sernet started task |
| Format | /F SERs,ASINITS Where: jobname Started task jobname |
| Comments | This command also display the address space requests that are waiting to run and the classes assigned. |
| Examples | /F SERT5,ASINITS |
| Response | SER0850I Operator command: ASINITSSER0901I Number of Address Spaces:32 Expiration Timeout:25 MinutesSER0902I Initiator:1 Classes:ABCD Maximum:4 Active:0SER0902I Initiator:2 Classes:ABCD Maximum:4 Active:0SER0902I Initiator:3 Classes:ABCD Maximum:4 Active:0SER0902I Initiator:4 Classes:ABCD Maximum:4 Active:0 |
...
ATTACH
| Purpose | Attach a subtask to an application running under the Sernet started task. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,aaa,ATTACH,tttttttt Where: jobname - STC jobname aaa - Application tttttttt - subtask CMN - ChangeMan ZMF or ZMF HLLX - High Level Language Exits SSV - Staging Versions IADS - Impact Analysis NFT - Event Notification |
| Comments | See the DETACH modify command. For SSV, the three staging version VSAM masters are attached to the started task. For IADS, the impact analysis data space is created and populated from the VSAM LDS at DD statement CMNIMPCT, and DD statement CMNIALOG is allocated and opened. |
| Examples | /F SERT5,CMN,ATTACH,SSV or Attach the Staging Versions subtask /F SERT5,ZMF,ATTACH,SSV /F SERT5,CMN,ATTACH,IADS or Attach the Impact Analysis subtask /F SERT5,ZMF,ATTACH,IADS |
| Responses | SER0850I Operator command: CMN,ATTACH,SSV CMN5300I CMNSTART Attach:U=CMNSTART,F1=ATTACH,F2=SSV,@TCA=17139000,@TCB=8C3CF0CMN5315I CMNSTART SSV Task AttachedCMN5385I CMNSSV Attempting SSV initialization CMNSSV (MVS-6.1.1) 2009050610.14CMN5388I CMNSSV SSV initialization completeSER0850I Operator command: CMN,ATTACH,IADSCMN5300I CMNSTART Attach:U=CMNSTART,F1=ATTACH,F2=IADS,@TCA=17115000,@TCB=8C329CMN5315I CMNSTART IADS Task AttachedCMN5391I CMNIAM00 Attempting to open the I/A Dataspace.CMN5392I CMNIAM00 I/A Dataspace OPEN, LDS: CMNTP.SERT5.CMNZMF.V6R1M1.IADSP |
...
CPOOLS
By default Sernet sets up five cell pools of sizes 1k, 4k, 32k, 40k and 64k. This command will issue the following message SER0624I for each of the five cell pools. That same processing will also occur during started-task termination.
SER0624I Cell pool size {0,S3} Request count {1,N4} High-water mark {2,N4}
Explanation: For each of the five cell pools this message will detail the number of requests made and the highest degree of concurrency.
Action: This message could be used to review the ACTIVEUSERS and ACTIVEMDUS specifications but otherwise it is purely informational.
...
CPR
| Purpose | Refresh or Restart Client Pack Registrar. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,CPR,command Where: jobname - STC jobname command - REFRESH or RESTART |
| Comments | Used |
| Examples | /F SERT5,CPR,REFRESH: Preserves the Shared Memory Object and sets it up as in the beginning/F SERT5,CPR,RESTART: Discards the Shared Memory Object and replaces it with a new one |
| Responses | SER0850I 00009000 Operator command: CPR,REFRESHSER0614I 00009000 Client Pack Registrar Refresh RequestedSER0850I 00009000 Operator command: CPR,RESTARTSER0615I 00009000 Client Pack Registrar Restart Requested |
...
DETACH
| Purpose | Detach a subtask from an application running under the Sernet started task. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,aaa,DETACH,tttttttt |
| Where: | |
| jobname - STC jobname | |
aaa - Application CMN or ZMF (ChangeMan ZMF) |
|
| tttttttt - One of the following subtasks: | |
HLLX - High Level Language Exits |
|
SSV - Staging Versions |
|
IADS - Impact Analysis |
|
NTF - Event Notification |
|
| Comments | See the ATTACH modify command. For SSV, the three staging version VSAM masters are closed and deallocated from the started task. For IADS, the impact analysis LDS is synchronized with the data space, the data space is closed, LDS is closed and deallocated from the started task, and DD statement CMNIALOG is closed and deallocated. CAUTION! When impact analysis is detached, these functions are affected: - Package audit fails with RC=20 - Baseline ripple and reverse baseline ripple jobs yield RC=04 in step DSPTM, and impact analysis updates are written to the CMNDELAY file. Transactions in the CMNDELAY file are not processed until the Sernet/ ZMF started task is restarted. - Query Impact and Query BOM return no results. |
| Examples | /F SERT5,CMN,DETACH,SSV or Detach the Staging Versions subtask /F SERT5,ZMF,DETACH,SSV /F SERT5,CMN,DETACH,IADS or Detach the Impact Analysis subtask /F SERT5,ZMF,DETACH,IADS |
| Responses | SER0850I Operator command: CMN,DETACH,SSVCMN5389I CMNSSV Terminating SSVCMN5387I CMNSSV SSV terminatedCMN5305I CMNSTART Detach:U=CMNSTART,F1=DETACH,F2=SSV,@TCA=17107000,@TCB=8C3CF0CMN5316I CMNSTART SSV Task DetachedSER0850I Operator command: CMN,DETACH,IADSCMN5394I CMNIAM00 Closing the I/A Dataspace.CMN5395I CMNIAM00 The I/A Dataspace is now offline.CMN5305I CMNSTART Detach:U=CMNSTART,F1=DETACH,F2=IADS,@TCA=170F5000,@TCB=8C42A08CMN5316I CMNSTART IADS Task Detached |
...
EXTEND
| Purpose | Extend the time when the Sernet started task automatically shuts down as specified in the EXPIRE or RUNFOR runtime parameters. |
| Application(s) | All applications running under a Sernet started task |
| Format | /F jobname,EXTEND,HhhMmm Where: jobname - Started task jobname hh - Hours to extend the started task expire time mm - Minutes to extend the started task expire time |
| Comments | The new system clock time for shutdown is displayed. |
| Examples | /F SERT5,EXTEND,H00M15 |
| Response | SER0850I Operator command: EXTEND,H00M15SER0870I Expiration time extended to 07:53 |
...
HALT
| Purpose | Stop the Sernet started task with an orderly termination process that closes VSAM files and disconnects from system resources. This command is the same as SHUTDOWN and is provided to comply with NetView terminology. |
| Application(s) | Sernet and applications running under the Sernet started task |
| Format | /F jobname,HALT,[n\ |
| Comments | No users are allowed to logon after a HALT command is issued. During the grace period, Sernet checks every 60 seconds for attached users. If all users have logged off, termination is initiated. If attached users are found, this message is sent to each TSO ID: SER2000I CMN Network shutting down; Please exit! CN(INTERNAL) After termination is initiated, the process may take several minutes to complete. |
| Examples | /F SERT5,HALT,1 /F SERT5,HALT /F SERT5,HALT,0 /F SERT5,HALT,1M |
| Response | SER0850I Operator command: HALT,0SER0944I SerNet orderly SHUTDOWN initiated; No grace period; Immediate terminatCMN5389I CMNSSV Terminating SSVCMN5394I CMNIAM00 Closing the I/A Dataspace. CMN5395I CMNIAM00 The I/A Dataspace is now offline.CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNPMASTCMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNCMPNTCMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNLOGCMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNRECVCMN5810I CMNSTART Change Man VSAM Files closed CMN5820I CMNSTART Change Man VSAM File StatisticsCMN5820I CMNSTART CMNPMAST CMNCMPNT CMNLOG CMNRECV CMNDELAY CCMN5820I CMNSTART Read Update 00000005 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Read Only 00000003 00000000 00000000 00000000 00000000 0 |
CMN5820I CMNSTART Read Next 00000447 00000000 00000000 00000000 00000001 0CMN5820I CMNSTART Write (Sync) 00000000 00000000 00000002 00000004 00000000 0CMN5820I CMNSTART Write (ASync) 00000000 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Update 00000004 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Delete 00000000 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Start 00000000 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Start Generic 00000149 00000000 00000000 00000000 00000001 0CMN5820I CMNSTART End Request 00000002 00000001 00000000 00000000 00000000 0 CMN5820I CMNSTART Dup Records 00000000 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Record locks 00000005 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Max locks used 00000001 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART CI locks found 00000000 00000000 00000000 00000000 00000000 0CMN5387I CMNSSV SSV terminatedCMN5305I CMNSTART Detach:U=CMNSTART,F1=DETACH,F2=IADS,@TCA=170F5000,@TCB=8C42ASER0989I Waiting for application to terminate: CMN CMN5305I CMNSTART Detach:U=CMNSTART,F1=DETACH,F2=INFO,@TCA=170FF000,@TCB=8C1E8CMN5305I CMNSTART Detach:U=CMNSTART,F1=DETACH,F2=SSV,@TCA=17108000,@TCB=8BF088CMN5313I CMNSTART Termination CompleteSER0990I Statistics; Real time: H02M30S53SER0991I Statistics; Applications: 4SER0992I Statistics; Users attached: 0SER0993I Statistics; Called count: 0SER0994I Statistics; Concurrent max: 0SER0995I Statistics; Abended: 0SER0996I Statistics; Detached inactive: 0SER0999I SerNet server "5" termination complete, RC=0 |
...
HOLD
| Purpose | Stop the ChangeMan ZMF internal scheduler from submitting installation jobs for packages that specify CMN (or ZMF) for the Installation Job Scheduler. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,CMN,HOLD or /F jobname,ZMF,HOLD Where: jobname - Started task jobname |
| Comments | Install jobs are not held for packages that use MANUAL or OTHER for the Installation Job Scheduler. Issue the HOLD modify command in the P environment started task to hold packages that have been distributed from a D or DP environment. |
| Examples | /F SERT5,CMN,HOLD or /F SERT5,ZMF,HOLD |
| Response | SER0850I Operator command: CMN,HOLD CMN5317I CMNSTART All scheduled jobs held |
...
LOCKS
| Purpose | Display information about serialization locks in force. |
| Application(s) | ChangeMan ZDD or ChangeMan ZMF4ECL |
| Format | /F jobname,XCH,LOCK or /F jobname CLP,LOCK Where: jobname - Started task jobname |
| Comments | Data displayed: <User_ID> - Logon ID for a given user<T_Elapsed> -Number of hours, minutes, and seconds that have elapsed since the lock was placed. If the hours exceed 24, days are displayed and seconds are dropped.<Type> - Type of lock applied. If the literal 'ENQ' is displayed, an ENQ is outstanding under Qname SPFEDIT for the displayed data set name and likely member name in parenthesis.<Locked_DsName(Member)...>Total= - Data set name and member name on which a temporary serialization lock was placed. Total number of locks that have been placed since the Sernet instance was started |
| Examples | /F SERT5,XCH,LOCK or /F SERT5,CLP,LOCK/F SERT5,XCH,LOCKS or /F SERT5,CLP,LOCKs |
| Response | SER0850I Operator command: XCH,LOCKSER2013I XCH <User_ID><T_Elapsed><Type><Locked_DsName(Member)...> Total=0SER2016I XCH No active locks found |
NEWS
| Purpose | Send instant messages to all active users logged on to a given ZMF instance. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,NEWS message |
Where: jobname is the started task jobname |
|
| Comments | The resulting message is passed through the existing notify interface and results in a TSO SEND command for all mainframe-based users and a datagram (TCP/IP SENDMSG via UDP) for all CLP users. Both halves of the CLP are updated to accept the new datagrams. |
| Examples | /F jobname,NEWS any text message up to about 94 bytes in length |
| Response |
RELEASE
| Purpose | Release installation jobs that are being held by the HOLD modify command. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,CMN,RELEASE or /F jobname,ZMF,RELEASE Where: jobname - Started task jobname |
| Comments | See the HOLD modify command. |
| Examples | /F SERT5,CMN,RELEASE or /F SERT5,ZMF,RELEASE |
| Response | SER0850I Operator command: CMN,RELEASECMN5320I CMNSTART All scheduled jobs released |
...
RELEASE,DELAY
| Purpose | Process contents of delay file. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,CMN,RELEASE,DELAY or /F jobname,ZMF,RELEASE,DELAY Where: jobname - Started task jobname |
| Comments | This command immediately processes the contents of the delay file. It runs asynchronously with other work in the started task. It does not prevent users from logging on and doing work, as happens at task startup. It should not be run when the Impact analysis files are detached. It can be run as many times as required when the task is up. A duplicate request ie one issued before a previous one is finished is ignored. |
| Examples | /F SERT7820,CMN,RELEASE,DELAY or /F SERT7820,ZMF,RELEASE,DELAY |
| Response | SER0850I Operator command: CMN,RELEASE,DELAYCMN7300I CMNSTART Attach:U=CMNSTART,F1=ATTACH,F2=SERVDLAY,@TCA=18CD6000,@TCB=8A3058 CMN7476ICMNSTART Delay file processing startedCMN7460I CMNDELAY - START of processingCMN7468I CMNDELAY - Waiting for resource => qname:rnameCMN7468I CMNDELAY - CHGMAN:CMNTP.S7.CMNDELAYCMN7469I CMNDELAY - Resource obtained successfully.CMN7800I SERT Opened VSAM file CMNTP.S7.CMNDELAYCMN7800I SERT Closed VSAM file CMNTP.S7.CMNDELAYCMN7461I CMNDELAY - END of processing 00000Note that the 4th character of the CMN messages is the instance ID, here it is ’7’. |
...
SHUTDOWN
| Purpose | Stop the Sernet started task with an orderly termination process that closes VSAM files and disconnects from system resources. This command is the same as HALT, which is provided to comply with NetView terminology. |
| Application(s) | Sernet and applications running under the Sernet started task |
| Format | /F jobname,SHUTDOWN,[n\ |
| Comments | No users are allowed to logon after a SHUTDOWN command is issued. During the grace period, Sernet checks every 60 seconds for attached users. If all users have logged off, termination is initiated. If attached users are found, this message is sent to each TSO ID: SER2000I CMN Network shutting down; Please exit! CN(INTERNAL) After termination is initiated, the process may take several minutes to complete. |
| Examples | /F SERT5,SHUTDOWN,1 /F SERT5,SH/F SERT5,SH,0/F SERT5,SHUTDOWN,1M |
| Response | SER0850I Operator command: SH,0SER0944I SerNet orderly SHUTDOWN initiated; No grace period; Immediate terminatCMN5389I CMNSSV Terminating SSVCMN5394I CMNIAM00 Closing the I/A Dataspace.CMN5395I CMNIAM00 The I/A Dataspace is now offline.CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNPMASTCMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNCMPNTCMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNLOGCMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNRECVCMN5810I CMNSTART Change Man VSAM Files closed CMN5820I CMNSTART Change Man VSAM File StatisticsCMN5820I CMNSTART CMNPMAST CMNCMPNT CMNLOG CMNRECV CMNDELAY CCMN5820I CMNSTART Read Update 00000005 00000000 00000000 00000000 00000000 0 |
CMN5820I CMNSTART Read Only 00000003 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Read Next 00000447 00000000 00000000 00000000 00000001 0CMN5820I CMNSTART Write (Sync) 00000000 00000000 00000002 00000004 00000000 0CMN5820I CMNSTART Write (ASync) 00000000 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Update 00000004 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Delete 00000000 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Start 00000000 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Start Generic 00000149 00000000 00000000 00000000 00000001 0CMN5820I CMNSTART End Request 00000002 00000001 00000000 00000000 00000000 0 CMN5820I CMNSTART Dup Records 00000000 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Record locks 00000005 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART Max locks used 00000001 00000000 00000000 00000000 00000000 0CMN5820I CMNSTART CI locks found 00000000 00000000 00000000 00000000 00000000 0CMN5387I CMNSSV SSV terminated CMN5305I CMNSTART Detach: |
|
U=CMNSTART,F1=DETACH,F2=IADS,@TCA=170F5000,@TCB=8C42ASER0989I Waiting for application to terminate: CMNCMN5305I CMNSTART Detach:U=CMNSTART,F1=DETACH,F2=INFO,@TCA=170FF000,@TCB=8C1E8CMN5305I CMNSTART Detach:U=CMNSTART,F1=DETACH,F2=SSV,@TCA=17108000,@TCB=8BF088CMN5313I CMNSTART Termination CompleteSER0990I Statistics; Real time: H02M30S53 |
|
SER0991I Statistics; Applications: 4 SER0992I Statistics; Users attached: 0SER0993I Statistics; Called count: 0SER0994I Statistics; Concurrent max: 0SER0995I Statistics; Abended: 0SER0996I Statistics; Detached inactive: 0SER0999I SerNet server "5" termination complete, RC=0 |
...
SNAPENV
| Purpose | Display information on started task region memory usage. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,SNAPENV Where: jobname - Started task jobname |
| Comments | |
| Examples | /F SERT5,SNAPENV |
| Response | SER0850I Operator command: SNAPENVSER0868I EPvt used=43,036K avail=1,701,860K Pvt used= 676K avail=8,516K |
...
STATS
| Purpose | Display VSAM file access statistics for the ChangeMan ZMF package master, component master, log, recovery, and delay files. |
| Application(s) | ChangeMan ZMF |
| Format | /F jobname,CMN,STATS or /F jobname,ZMF,STATS Where: jobname - Started task jobname |
| Comments | If you license the ChangeMan ZMF INFO Option, statistics for the INFO VSAM interface file are also displayed. |
| Examples | /F SERT5,CMN,STATS or /F SERT5,ZMF,STATS |
| Response | SER0850I Operator command: CMN,STATSCMN5820I CMNSTART Change Man VSAM File StatisticsCMN5820I CMNSTART CMNPMAST CMNCMPNT CMNLOG CMNRECV CMNDELAYCMN5820I CMNSTART Read Update 00000005 00000000 00000000 00000000 00000000CMN5820I CMNSTART Read Only 00000003 00000000 00000000 00000000 00000000CMN5820I CMNSTART Read Next 00000438 00000000 00000000 00000000 00000001 CMN5820I CMNSTART Write (Sync) 00000000 00000000 00000001 00000004 00000000CMN5820I CMNSTART Write (ASync) 00000000 00000000 00000000 00000000 00000000CMN5820I CMNSTART Update 00000004 00000000 00000000 00000000 00000000CMN5820I CMNSTART Delete 00000000 00000000 00000000 00000000 00000000 CMN5820I CMNSTART Start 00000000 00000000 00000000 00000000 00000000CMN5820I CMNSTART Start Generic 00000146 00000000 00000000 00000000 00000001CMN5820I CMNSTART End Request 00000002 00000001 00000000 00000000 00000000CMN5820I CMNSTART Dup Records 00000000 00000000 00000000 00000000 00000000CMN5820I CMNSTART Record locks 00000005 00000000 00000000 00000000 00000000CMN5820I CMNSTART Max locks used 00000001 00000000 00000000 00000000 00000000CMN5820I CMNSTART CI locks found 00000000 00000000 00000000 00000000 00000000 |
...
TCPIP
| Purpose | Manage TCP/IP for applications running under Sernet: - Gracefully detach inactive users connected to a Sernet started task through TCP/IP, and stop TCP/IP without disrupting users connected through cross memory services. - Start TCP/IP for use by Sernet. - Gracefully disconnect inactive users using TCP/IP, stop and start TCP/ IP without disrupting users connected through cross memory services. |
| Application(s) | Sernet |
| Format | /F jobname,TCPIP,action,[mmm],[tcpipname] Where: jobname - started task jobname action - START, STOP, RESTART mmm - Minutes of inactivity after a STOP command before a TCP/IP user is automatically detached. If mmm not specified, default is 0. tcpipname - TCPIP procedure name for START and RESTART |
| Comments | After the TCPIP command is entered, subsequent actions such as detaching inactive users, stopping TCP/IP, and restarting TCP/IP will be executed. Note that the command can only be considered complete when the following message is seen in the JESMSGLG of the Sernet STC:SER0915I TCP/IP request finished processing |
STOP: When the STOP command is entered, no further TCP/IP connections are accepted, currently attached users are listed, and the following notification is issued to users connected through TCP/IP:SER2060T TCP/IP connections being terminated due to operator request.This message is reissued each minute until the TCP/ IP user disconnects or is automatically detached. A TCP/IP user is automatically detached when they have been inactive for the specified mmm interval. After all TCP/IP users disconnect or are automatically detached, the controlling task will terminate its connection to TCP/IP. |
|
| START: This command initializes TCP/IP communications. If tcpipname isn't specified in the TCPIP command, a connection is made to the default stack. Otherwise, a connection is made to the stack name that was specified. | |
| RESTART: The RESTART command is a combination of the STOP and START commands. A connection to TCP/IP is refreshed one minute after the last inactive TCP/IP user is detached. | |
Note: Use discrete STOP and START commands when you want to recycle the TCP/IP STC. Use the RESTART command with a tcpipname parameter when you want to switch TCP/IP stacks. In all cases, the request can only be considered complete when the following message is seen in the JESMSGLG of the Sernet STC:SER0915I TCP/IP request finished processing |
|
| Examples | /F SERT5,TCPIP,STOP/F SERT5,TCPIP,START/F SERT5,TCPIP,RESTART/F SERx,TCPIP,STOP,IMMED |
| Response | SER0850I Operator command: TCPIP,STOPSER0916I TCPIP Stop RequestedSER1020I SYSTEM TCP/IP SETSOCKOPT: RC=FFFF ErrNo=1027 TCA=00010000 Task=SERTCB=008DAE88 TIE=15B62F50 Sock=0000SER1020I SYSTEM TCP/IP CLOSE: RC=FFFF ErrNo=1027 TCA=00010000 Task=SERTCB=008DAE88 TIE=15B62F50 Sock=0000SER0920I Current Users:0 Maximum Users:32767SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0SER2012I XCH No active users foundSER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0 |
SER2012I CMN No active users foundSER1020I XCH TCP/IP CLOSE: RC=FFFF ErrNo=1027 TCA=15B6E000 Task=XCH00001TCB=008CC888 TIE=15B7C150 Sock=0000SER0850I Operator command: TCPIP,STARTSER0915I TCPIP Start RequestedSER1018I SYSTEM The following TCP/IP procedures are actio=10197 TCA=00010000 Task=SERTCB=008DAE88 TIE=15B62F50 Sock=0000SER1020I CMNSTART TCP/IP BIND: RC=FFFF ErrNo=48 TCA=15B98000 Task=CMNTCB=008CC0D8 TIE=15BC6090 Sockve: TCPIPSER1020I SYSTEM TCP/IP INITAPI: RC=FFFF ErrN=0000SER1014E CMNSTART *Error* Specified port number already in use: 6051SER1000I XCH TCP/IP environment active at 10.35.11.100..6052 |
|
SER1001I XCH TCP/IP local host name: C001SER0826I LIBR not foundSER0850I Operator command: TCPIP,RESTARTSER0917I TCPIP Restart RequestedSER0920I Current Users:0 Maximum Users:32767SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0SER2012I XCH No active users foundSER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0SER2012I CMN No active users foundSER1000I XCH TCP/IP environment active at 10.35.11.100..6052SER1001I XCH TCP/IP local host name: C001SER0850I Operator command: TCPIP,STOP,IMEDSER0916I TCPIP Stop RequestedSER1020I SYSTEM TCP/IP SETSOCKOPT: RC=FFFF ErrNo=1027 TCA=00010000 Task=SERTCB=008DAE88 TIE=15B62F50 Sock=0000SER1020I SYSTEM TCP/IP CLOSE: RC=FFFF ErrNo=1027 TCA=00010000 Task=SERTCB=008DAE88 TIE=15B62F50 Sock=0000SER0920I Current Users:2 Maximum Users:32767SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0SER2012I XCH No active users foundSER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=2SER2011I CMN 001 USER240 H00M01S05 H00M01S04 10.35.11.100SER2011I CMN 002 USER239 H00M00S36 H00M00S33 10.30.224.18 |
...
USERS
| Purpose | Display users connected to the Sernet started task. If the application is specified, only users connected to that application are displayed. If SUMMARY is specified, only a count of users connected to each application is displayed. |
| Application(s) | All applications running under a Sernet started task |
| Format | /F jobname[,aaa],USERS |
| /F jobname,USERS[,SUMMARY] | |
| Where: | |
| jobname - Started task jobname | |
| aaa - Application running under Sernet | |
| Comments | Data displayed: |
| ### - Three-digit relative number for the user. | |
| User_ID - Logon ID for the user. | |
| T_Elapsed - Number of hours, minutes, and seconds that have elapsed since the initial logon. If hours exceed 24, days are displayed and seconds are dropped. | |
| T_LastAct - Number of hours, minutes, and seconds that have elapsed since the last contact with the Sernet instance. If hours exceed 24, days are displayed and seconds are dropped. | |
| Partner Identifier - Fully qualified partner logical unit name or TCP/IP address of the workstation. Nothing is displayed if the connection is through cross memory services. | |
| Current/Max=0/0 - No longer maintained by Sernet. | |
| Examples | /F SERT4712,USERS |
| /F SERT4712,CMN,USERS or /F SERT5,ZMF,LOCK | |
| /F SERT4712,USERS,SUMMARY | |
| Response | SER0850I Operator command: USERSSER0920I Current Users:0 Maximum Users:32767 SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0SER2012I XCH No active users foundSER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0SER2012I CMN No active users foundSER0850I Operator command: CMN,USERS<>SER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0SER2012I CMN No active users foundSER0850I Operator command: USERS,SUMMARYSER0920I Current Users:0 Maximum Users:32767SER2009I XCH Users: 0SER2009I CMN Users: 0 |
...
WARN
| Purpose | Controls XML Services syntax warnings facility. |
| Application(s) | XML Services |
| Format | /F jobname,WARN,[YES|NO] |
| Where: jobname - Started task jobname | |
| Comments | When SERXMLI is unable to recognize an XML tag, it can write a warning message to SERPRINT. There are three ways to enable or disable these warning messages: |
- Sernet modify command: /F jobname,WARN,[YES |NO] |
|
- Sernet keyword option input to the started task at startup: WARN=[YES |NO] |
|
| - XML tag in the |
|
<warn>Y</warn> |
|
| See the XML Services User’s Guide. | |
| Examples | /F SERT4712,WARN,YES - Enable XML Services syntax warning /F SERT4712,WARN,NO - Enable XML Services syntax warning /F SERT4712,WARN - Display status of XML Services syntax warning |
| Response | SER0850I Operator command: WARN,YESSER0960I XML syntax warning has been turned onSER0850I Operator command: WARN,NOSER0959I XML syntax warning has been turned off SER0850I Operator command: WARNSER0961I XML syntax warning is: Off |
...
Restricted Modify Commands
These modify commands will add significant processing overhead and are to be used only as directed by Micro Focus Customer Care. They are included here to provide format specifications and examples.
NETTRACE
| Purpose | Display the contents of communications buffers to trace data that flows across the network. Dump the contents of each buffer into the SERPRINT sysout data set. |
| Application(s) | All applications running under a Sernet started task |
| Format | /F jobname,NETTRACE {ON|OFF|DISPLAY},[LUNAME|TCP|USER],TRACESIZE=size |
| Where: | |
| jobname - Started task jobname | |
| ON - Enable NETTRACE as specified | |
| OFF - Disable NETTRACE as specified | |
| DISPLAY - Display all NETTRACE specifications currently enabled | |
| LUNAME=data - Trace this LU. Abbreviation: L=. Trailing *wildcard permitted. | |
| TCP=data - Trace this TCP/IP address. Abbreviation: T=for trace. Trailing * wildcard permitted in each address segment. | |
| USER=data - Trace this user ID. Abbreviation: U=. Trailing * wild card permitted. | |
| TRACESIZE=data - Specifies maximum amount of data to display for each call to the network tracing routines. Default is 1024 bytes, minimum is 128 bytes. | |
| Comments | The TRACE modify command is not a toggle switch. You must turn OFF any NETTRACE that you turn ON. You cannot use a wildcard to turn OFF multiple TRACE,ON commands. NETTRACE can generate high volumes of output if all users are traced or there is a high level of activity for individual users that are traced. |
| Examples | /F SERT5,NETTRACE,ON,USER=USER239 /F SERT5,NETTRACE,ON,TCP=111.11.111.111 /F SERT5,NETTRACE,DISPLAY /F SERT5,NETTRACE,OFF,U=USER239 /F SERT5,NETTRACE,OFF,T=111.11.111.111 |
| Response | SER0850I Operator command: NETTRACE,ON,USER=USER239SER0864I NETTRACE enabled: USER=USER239,SIZE=00256 |
...
REFRESH
| Purpose | Delete and reload specified load module. |
| Application(s) | Sernet |
| Format | /F jobname,REFRESH,modname Where: jobname - Started task jobname modname - Module to be refreshed |
| Comments | This modify command refreshes load modules that are loaded by the started task, and uses SER1405I messages to display details of the old and new. |
| Examples | /F SERT5,REFRESH,CMNVPKGE |
| Response | SER0850I Operator command: REFRESH,CMNVPKGESER1405I Name=CMNVPKGE CMNVPKGE (MVS-F.L.O) 20171005 12.25SER1402I Name=CMNVPKGE old/new EPA=16779000/16779000 RC=0 SER1403I Name=CMNVPKGE old/new token=F7F6B992-00007FFF/9CD40CE8-00007FFFSER1405I Name=CMNVPKGE CMNVPKGE (MVS-8.2.0) 20171025 05.12 |
...
TRACE
| Purpose | Modify the TRACE options in effect. | |
| Application(s) | Sernet, ChangeMan ZMF | |
| Format | /F jobname,TRACE[,DISPLAY] | |
| [,ON,CMN|SER,CLASS=(n,n,n...)] | ||
| [,OFF,CMN|SER,CLASS=(n,n,n,...)] | ||
| [,ON,USER=uuuuuuu[*] | ||
| [,OFF,USER=uuuuuuu[*] | ||
| ON is a synonym for YES | ||
| OFF is a synonym for NO | ||
| ZMF is a synonym for CMN | ||
| Where: | ||
| jobname | Started task jobname | |
| DISPLAY | Display all TRACE facilities currently enabled | |
| ON or YES | Enable TRACE as specified | |
| OFF or NO | Disable TRACE as specified | |
| SER | Sernet | |
| CMN or ZMF | ChangeMan ZMF | |
| n | Trace class, numeric 1-32 | |
| 1 - All CMN traces not listed below | ||
| 2 - CMNATACH user conversation incoming request and outgoing response. I.E. “TRACE IN …” and “TRACE OUT …”. | ||
| CMNENTFY event notification. | ||
| CMNSCHED CMN scheduler. | ||
| 3 - VSAM CMAST data interim results. This shows long and short CMAST data in a common format | ||
| 4 - CMNVRLIO VSAM i/o response (major/minor/key/rc/fdbk) | ||
| USER=uuuuuuu | Limit Sernet trace to this user ID (trailing wildcard permitted) | |
| ID=m | Numeric identifier for trace USER that is used to turn trace user limit off | |
| Comments | If no user ID is specified, all user IDs are traced. The TRACE,ON,USER= command may be issued more than once to add user IDs to the list of eligible messages. TRACE options are logically ORed, meaning that if a message matches one of the specifications, the message is displayed. ChangeMan ZMF messages are never affected by a user ID limit and are always shown for all user IDs. | |
| All trace classes can also be enabled/disabled with the following format: | ||
| /F stcname,TRACE,YES,CMN or /F stcname,TRACE,YES,ZMF | ||
| /F stcname,TRACE,YES,SER | ||
| Once the problem requiring the trace has been recreated, immediately disable all the traces by replacing any 'YES' with 'NO' and/or 'ON' with 'OFF' in each of the above modify commands. |
Trace Examples
In the following examples of the TRACE modify command:
-
Each command that is entered on the operator console or in SDSF is followed by the response that is displayed in the SERPRINT data set.
-
Trace specifications in these examples are cumulative. Trace DISPLAY commands show the cumulative trace options in effect.
-
No TRACE keyword option was included in the Sernet startup parameters.
Display the current trace settings.
/F SERT5,TRACE,DISPLAY
SER0850I Operator command: TRACE,DISPLAY
SER0966I Classes active for component SER: None
SER0966I Classes active for component CMN: None
Turn on trace Class 1 and 2 for Sernet and ChangeMan ZMF:
/F SERT5,TRACE,ON,SER,CLASS=(1,2)
SER0850I Operator command: TRACE,ON,SER,CLASS=(1,2)
SER0964I Trace classes set
/F SERT5,TRACE,ON,CMN,CLASS=(1,2)
SER0850I Operator command: TRACE,ON,CMN,CLASS=(1,2)
SER0964I Trace classes set
/F SERT5,TRACE,DISPLAY
SER0850I Operator command: TRACE,DISPLAY
SER0966I Classes active for component SER: 01 02
SER0966I Classes active for component CMN: 01 02
Limit trace to user ID USER239 and USER240:
/F SERT5,TRACE,ON,USER=USER239
SER0850I Operator command: TRACE,ON,USER=USER239
SER0924I Trace started for user: USER239, ID: 1
/F SERT5,TRACE,ON,USER=USER240
SER0850I Operator command: TRACE,ON,USER=USER240
SER0924I Trace started for user: USER240, ID: 2
/F SERT5,TRACE,DISPLAY
SER0850I Operator command: TRACE,DISPLAY SER0922I information follows:
SER0923I Trace ID: 2 User ID: USER240
SER0923I Trace ID: 1 User ID: USER239
SER0966I Classes active for component SER: 01 02
SER0966I Classes active for component CMN: 01 02
Caution
Trace classes 1 and 2 ON for both Sernet and ChangeMan ZMF produces the most verbose output. Over 350 lines of trace data is displayed in the SERPRINT data set when one user executes the following steps:
-
Logon to ChangeMan ZMF
-
Package list for the ACTP application
-
Log off ChangeMan ZMF
Turn off Class 2 trace for ChangeMan ZMF:
/F SERT5,TRACE,OFF,CMN,CLASS=(2)
SER0850I Operator command: TRACE,OFF,CMN,CLASS=(2)
SER0964I Trace classes set
/F SERT5,TRACE,DISPLAY
SER0850I Operator command: TRACE,DISPLAY SER0922I information follows:
SER0923I Trace ID: 2 User ID: USER240
SER0923I Trace ID: 1 User ID: USER239
SER0966I Classes active for component SER: 01 02
SER0966I Classes active for component CMN: 01
Turn off Class 1 trace for ChangeMan ZMF:
/F SERT5,TRACE,OFF,CMN,CLASS=(1)
SER0850I Operator command: TRACE,OFF,CMN,CLASS=(1)
SER0964I Trace classes set
/F SERT5,TRACE,DISPLAY
SER0850I Operator command: TRACE,DISPLAY SER0922I information follows:
SER0923I Trace ID: 2 User ID: USER240
SER0923I Trace ID: 1 User ID: USER239
SER0966I Classes active for component SER: 01 02
SER0966I Classes active for component CMN: None
Turn off the USER239 trace limit and the USER240 trace limits:
/F SERT5,TRACE,OFF,ID=1
SER0850I Operator command: TRACE,OFF,ID=1
SER0883I TRACE ID 1 turned off
/F SERT5,TRACE,OFF,USER=USER240
SER0850I Operator command: TRACE,OFF,USER=USER240
SER0883I TRACE ID 2 turned off
/F SERT5,TRACE,DISPLAY
SER0850I Operator command: TRACE,DISPLAY
SER0966I Classes active for component SER: 01 02
SER0966I Classes active for component CMN: None
Turn off Class 1 and 2 trace for Sernet:
/F SERT5,TRACE,OFF,SER,CLASS=(1,2)
SER0850I Operator command: TRACE,OFF,SER,CLASS=(1,2)
SER0964I Trace classes set
/F SERT5,TRACE,DISPLAY
SER0850I Operator command: TRACE,DISPLAY
SER0966I Classes active for component SER: None
SER0966I Classes active for component CMN: None