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
Restricted Modify Commands

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: ABEND` `SER0952W 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: ASIDS` `SER0901I Number of Address Spaces:16 Expiration Timeout:20 Minutes` `SER0904I 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,n` Where: 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:0` `SER0902I Initiator:2 Classes:ABCD Maximum:4 Active:0` `SER0902I Initiator:3 Classes:ABC Maximum:10 Active:0` `SER0902I 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: ASINITS` `SER0901I Number of Address Spaces:32 Expiration Timeout:25 Minutes` `SER0902I Initiator:1 Classes:ABCD Maximum:4 Active:0` `SER0902I Initiator:2 Classes:ABCD Maximum:4 Active:0` `SER0902I Initiator:3 Classes:ABCD Maximum:4 Active:0` `SER0902I 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=8C3CF0` `CMN5315I CMNSTART SSV Task Attached` `CMN5385I CMNSSV Attempting SSV initialization CMNSSV (MVS-6.1.1) 20090506` `10.14` `CMN5388I CMNSSV SSV initialization complete` `SER0850I Operator command: CMN,ATTACH,IADS` `CMN5300I CMNSTART Attach:` `U=CMNSTART,F1=ATTACH,F2=IADS,@TCA=17115000,@TCB=8C329` `CMN5315I CMNSTART IADS Task Attached` `CMN5391I 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,REFRESH` `SER0614I 00009000 Client Pack Registrar Refresh Requested` `SER0850I 00009000 Operator command: CPR,RESTART` `SER0615I 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,SSV` `CMN5389I CMNSSV Terminating SSV` `CMN5387I CMNSSV SSV terminated` `CMN5305I CMNSTART Detach:` `U=CMNSTART,F1=DETACH,F2=SSV,@TCA=17107000,@TCB=8C3CF0` `CMN5316I CMNSTART SSV Task Detached` `SER0850I Operator command: CMN,DETACH,IADS` `CMN5394I 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=8C42A08` `CMN5316I 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,H00M15` `SER0870I 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,0` `SER0944I SerNet orderly SHUTDOWN initiated; No grace period; Immediate terminat` `CMN5389I CMNSSV Terminating SSV` `CMN5394I CMNIAM00 Closing the I/A Dataspace.` `CMN5395I CMNIAM00 The I/A Dataspace is now offline.` `CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNPMAST` `CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNCMPNT` `CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNLOG` `CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNRECV` `CMN5810I CMNSTART Change Man VSAM Files closed` `CMN5820I CMNSTART Change Man VSAM File Statistics` `CMN5820I CMNSTART CMNPMAST CMNCMPNT CMNLOG CMNRECV CMNDELAY C` `CMN5820I CMNSTART Read Update 00000005 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Read Only 00000003 00000000 00000000 00000000 00000000 0`
	`CMN5820I CMNSTART Read Next 00000447 00000000 00000000 00000000 00000001 0` `CMN5820I CMNSTART Write (Sync) 00000000 00000000 00000002 00000004 00000000 0` `CMN5820I CMNSTART Write (ASync) 00000000 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Update 00000004 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Delete 00000000 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Start 00000000 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Start Generic 00000149 00000000 00000000 00000000 00000001 0` `CMN5820I CMNSTART End Request 00000002 00000001 00000000 00000000 00000000 0` `CMN5820I CMNSTART Dup Records 00000000 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Record locks 00000005 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Max locks used 00000001 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART CI locks found 00000000 00000000 00000000 00000000 00000000 0` `CMN5387I CMNSSV SSV terminated` `CMN5305I CMNSTART Detach:` `U=CMNSTART,F1=DETACH,F2=IADS,@TCA=170F5000,@TCB=8C42A` `SER0989I Waiting for application to terminate: CMN` `CMN5305I CMNSTART Detach:` `U=CMNSTART,F1=DETACH,F2=INFO,@TCA=170FF000,@TCB=8C1E8` `CMN5305I CMNSTART Detach:` `U=CMNSTART,F1=DETACH,F2=SSV,@TCA=17108000,@TCB=8BF088` `CMN5313I CMNSTART Termination Complete` `SER0990I Statistics; Real time: H02M30S53` `SER0991I Statistics; Applications: 4` `SER0992I Statistics; Users attached: 0` `SER0993I Statistics; Called count: 0` `SER0994I Statistics; Concurrent max: 0` `SER0995I Statistics; Abended: 0` `SER0996I Statistics; Detached inactive: 0` `SER0999I 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,LOCK` `SER2013I XCH <User_ID><T_Elapsed><Type><Locked_DsName(Member)...> Total=0` `SER2016I 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,RELEASE` `CMN5320I 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,DELAY` `CMN7300I CMNSTART Attach:` `U=CMNSTART,F1=ATTACH,F2=SERVDLAY,@TCA=18CD6000,@TCB=8A3058 CMN7476I` `CMNSTART Delay file processing started` `CMN7460I CMNDELAY - START of processing` `CMN7468I CMNDELAY - Waiting for resource => qname:rname` `CMN7468I CMNDELAY - CHGMAN:CMNTP.S7.CMNDELAY` `CMN7469I CMNDELAY - Resource obtained successfully.` `CMN7800I SERT Opened VSAM file CMNTP.S7.CMNDELAY` `CMN7800I SERT Closed VSAM file CMNTP.S7.CMNDELAY` `CMN7461I CMNDELAY - END of processing 00000` `Note 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,0` `SER0944I SerNet orderly SHUTDOWN initiated; No grace period; Immediate terminat` `CMN5389I CMNSSV Terminating SSV` `CMN5394I CMNIAM00 Closing the I/A Dataspace.` `CMN5395I CMNIAM00 The I/A Dataspace is now offline.` `CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNPMAST` `CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNCMPNT` `CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNLOG` `CMN5800I CMNSTART Closed VSAM file CMNTP.SERT5.CMNZMF.V6R1M1.CMNRECV` `CMN5810I CMNSTART Change Man VSAM Files closed` `CMN5820I CMNSTART Change Man VSAM File Statistics` `CMN5820I CMNSTART CMNPMAST CMNCMPNT CMNLOG CMNRECV CMNDELAY C` `CMN5820I CMNSTART Read Update 00000005 00000000 00000000 00000000 00000000 0`
	`CMN5820I CMNSTART Read Only 00000003 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Read Next 00000447 00000000 00000000 00000000 00000001 0` `CMN5820I CMNSTART Write (Sync) 00000000 00000000 00000002 00000004 00000000 0` `CMN5820I CMNSTART Write (ASync) 00000000 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Update 00000004 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Delete 00000000 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Start 00000000 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Start Generic 00000149 00000000 00000000 00000000 00000001 0` `CMN5820I CMNSTART End Request 00000002 00000001 00000000 00000000 00000000 0` `CMN5820I CMNSTART Dup Records 00000000 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Record locks 00000005 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART Max locks used 00000001 00000000 00000000 00000000 00000000 0` `CMN5820I CMNSTART CI locks found 00000000 00000000 00000000 00000000 00000000 0` `CMN5387I CMNSSV SSV terminated CMN5305I CMNSTART Detach:`
	`U=CMNSTART,F1=DETACH,F2=IADS,@TCA=170F5000,@TCB=8C42A` `SER0989I Waiting for application to terminate: CMN` `CMN5305I CMNSTART Detach:` `U=CMNSTART,F1=DETACH,F2=INFO,@TCA=170FF000,@TCB=8C1E8` `CMN5305I CMNSTART Detach:` `U=CMNSTART,F1=DETACH,F2=SSV,@TCA=17108000,@TCB=8BF088` `CMN5313I CMNSTART Termination Complete` `SER0990I Statistics; Real time: H02M30S53`
	`SER0991I Statistics; Applications: 4` `SER0992I Statistics; Users attached: 0` `SER0993I Statistics; Called count: 0` `SER0994I Statistics; Concurrent max: 0` `SER0995I Statistics; Abended: 0` `SER0996I Statistics; Detached inactive: 0` `SER0999I 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: SNAPENV` `SER0868I 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,STATS` `CMN5820I CMNSTART Change Man VSAM File Statistics` `CMN5820I CMNSTART CMNPMAST CMNCMPNT CMNLOG CMNRECV CMNDELAY` `CMN5820I CMNSTART Read Update 00000005 00000000 00000000 00000000 00000000` `CMN5820I CMNSTART Read Only 00000003 00000000 00000000 00000000 00000000` `CMN5820I CMNSTART Read Next 00000438 00000000 00000000 00000000 00000001` `CMN5820I CMNSTART Write (Sync) 00000000 00000000 00000001 00000004 00000000` `CMN5820I CMNSTART Write (ASync) 00000000 00000000 00000000 00000000 00000000` `CMN5820I CMNSTART Update 00000004 00000000 00000000 00000000 00000000` `CMN5820I CMNSTART Delete 00000000 00000000 00000000 00000000 00000000` `CMN5820I CMNSTART Start 00000000 00000000 00000000 00000000 00000000` `CMN5820I CMNSTART Start Generic 00000146 00000000 00000000 00000000 00000001` `CMN5820I CMNSTART End Request 00000002 00000001 00000000 00000000 00000000` `CMN5820I CMNSTART Dup Records 00000000 00000000 00000000 00000000 00000000` `CMN5820I CMNSTART Record locks 00000005 00000000 00000000 00000000 00000000` `CMN5820I CMNSTART Max locks used 00000001 00000000 00000000 00000000 00000000` `CMN5820I 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,STOP` `SER0916I TCPIP Stop Requested` `SER1020I SYSTEM TCP/IP SETSOCKOPT: RC=FFFF ErrNo=1027 TCA=00010000 Task=SER` `TCB=008DAE88 TIE=15B62F50 Sock=0000` `SER1020I SYSTEM TCP/IP CLOSE: RC=FFFF ErrNo=1027 TCA=00010000 Task=SER` `TCB=008DAE88 TIE=15B62F50 Sock=0000` `SER0920I Current Users:0 Maximum Users:32767` `SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0` `SER2012I XCH No active users found` `SER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0`
	`SER2012I CMN No active users found` `SER1020I XCH TCP/IP CLOSE: RC=FFFF ErrNo=1027 TCA=15B6E000 Task=XCH00001` `TCB=008CC888 TIE=15B7C150 Sock=0000` `SER0850I Operator command: TCPIP,START` `SER0915I TCPIP Start Requested` `SER1018I SYSTEM The following TCP/IP procedures are actio=10197 TCA=00010000 Task=SER` `TCB=008DAE88 TIE=15B62F50 Sock=0000` `SER1020I CMNSTART TCP/IP BIND: RC=FFFF ErrNo=48 TCA=15B98000 Task=CMN` `TCB=008CC0D8 TIE=15BC6090 Sockve: TCPIP` `SER1020I SYSTEM TCP/IP INITAPI: RC=FFFF ErrN=0000` `SER1014E CMNSTART Error Specified port number already in use: 6051` `SER1000I XCH TCP/IP environment active at 10.35.11.100..6052`
	`SER1001I XCH TCP/IP local host name: C001` `SER0826I LIBR not found` `SER0850I Operator command: TCPIP,RESTART` `SER0917I TCPIP Restart Requested` `SER0920I Current Users:0 Maximum Users:32767` `SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0` `SER2012I XCH No active users found` `SER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0` `SER2012I CMN No active users found` `SER1000I XCH TCP/IP environment active at 10.35.11.100..6052` `SER1001I XCH TCP/IP local host name: C001` `SER0850I Operator command: TCPIP,STOP,IMED` `SER0916I TCPIP Stop Requested` `SER1020I SYSTEM TCP/IP SETSOCKOPT: RC=FFFF ErrNo=1027 TCA=00010000 Task=SER` `TCB=008DAE88 TIE=15B62F50 Sock=0000` `SER1020I SYSTEM TCP/IP CLOSE: RC=FFFF ErrNo=1027 TCA=00010000 Task=SER` `TCB=008DAE88 TIE=15B62F50 Sock=0000` `SER0920I Current Users:2 Maximum Users:32767` `SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0` `SER2012I XCH No active users found` `SER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=2` `SER2011I CMN 001 USER240 H00M01S05 H00M01S04 10.35.11.100` `SER2011I 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: USERS` `SER0920I Current Users:0 Maximum Users:32767` `SER2010I XCH ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0` `SER2012I XCH No active users found` `SER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0` `SER2012I CMN No active users found` `SER0850I Operator command: CMN,USERS`<>`SER2010I CMN ###<User_ID><T_Elapsed><T_LastAct><Partner Identifier> Users=0` `SER2012I CMN No active users found` `SER0850I Operator command: USERS,SUMMARY` `SER0920I Current Users:0 Maximum Users:32767` `SER2009I XCH Users: 0` `SER2009I 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 of the request message:
	`<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,YES` `SER0960I XML syntax warning has been turned on` `SER0850I Operator command: WARN,NO` `SER0959I XML syntax warning has been turned off` `SER0850I Operator command: WARN` `SER0961I 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=USER239` `SER0864I 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,CMNVPKGE` `SER1405I Name=CMNVPKGE CMNVPKGE (MVS-F.L.O) 20171005 12.25` `SER1402I Name=CMNVPKGE old/new EPA=16779000/16779000 RC=0 SER1403I Name=CMNVPKGE old/new token=F7F6B992-00007FFF/9CD40CE8-00007FFF` `SER1405I 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