Skip to content

Starting, Connecting, and Stopping

This chapter describes how to start a SERNET started task and how to connect to ChangeMan ZMF. It also describes how to stop SERNET, giving ChangeMan ZMF users a grace period to end their sessions.

Start SERNET

Use a START command to start a SERNET instance and initialize ChangeMan ZMF. Variations of the START command are:

  • START SERPROC1

  • S SERPROC.SERTASK2,ID=2

  • S SERPROC,JOBNAME=SERTASK3,ID=3

See SERNET Started Task Names for a discussion of the START command and SERNET started task names.

Note

You may use z/OS START command parameter REUSASID=YES unless you intend to use ChangeMan ZMF ERO or ChangeMan ZMF Db2 options. Example: S SERPROC,JOBNAME=SERTASK3,REUSASID=YES,ID=3 See Reusable Address Space Identifiers (ASID).

SERPRINT Messages

SERNET messages, License Manager messages, and some ChangeMan ZMF messages are displayed in the SERPRINT sysout data set for the SERNET started task. SERNET messages are explained in the ChangeMan ZMF Messages Guide.

In a SERNET instance running ChangeMan ZMF, messages in SERPRINT have the following formats:

SERnnnnt LICnnnnt CMNnnnnt

Where nnnn is a unique number among all SERNET messages.

SERPRINT Message Example

The date/time stamp at the left of each line is not shown.

SER0800I SerNet - Initialization in progress: CSA=00007000
SER0607I Operating system from ECVT is z/OS            0203000
SER0801I Execution parameters specified:
SER0801I SUBSYS=7
SER0801I DDNAME=PARMLIB
SER0801I < DDNAME: PARMLIB
SER0801I   SUBSYS=7
SER0801I   SDNOTIFY=M55
SER0801I   TIMEOUT=360
SER0801I   CMN=6123
SER0801I   XCH=6124
SER0801I   EX005=NO
SER0801I >
SER0611I Storage protection is being used
SER0606I SEREX006 Activated
SER0604I The prefix for the dynamic allocation of log datasets is CMNTP.TEMP .SER7.Q001
LIC0010I Machine Seq: D5907 Type: 2965 Model: G03 Capacity: 58 MSU
LIC0013I LPAR Group: QGROUP Capacity: 56 MSU
LIC0011I LPAR ID: 05 Name: Q001 Capacity: 39 MSU
LIC0012I Licensing version: 4.3.1 Date/Time: 2018/04/19 00:47:57 Key: d1d43270
LIC0045I ChangeMan ZDD licensed to SERENA SOFTWARE UK
LIC0010I Machine Seq: D5907 Type: 2965 Model: G03 Capacity: 58 MSU
LIC0013I LPAR Group: QGROUP Capacity: 56 MSU
LIC0011I LPAR ID: 05 Name: Q001 Capacity: 39 MSU
LIC0012I Licensing version: 4.3.1 Date/Time: 2018/04/19 00:47:57 Key: d1d43270
LIC0045I ChangeMan ZMF licensed to SERENA SOFTWARE UK
SER1018I           The following TCP/IP procedures are active: TCPIP
SER0660I Unix services are available
SER0821I ZDD (ChangeMan ZDD) licensed
SER0821I ECL (ChangeMan Eclipse) licensed
SER1004I XCH       TCP/IP v6 socket acquired
SER1000I XCH       TCP/IP environment active at 151.155.151.104..6124
SER1001I XCH       TCP/IP local host name: Q001
SER0835I TCB Manager active
SER0832I Address Space Manager active
SER0833I XML Data Space Manager active
SER0613I Client Pack Registrar Active
SER0821I ZMF (ChangeMan ZMF) licensed
SER1004I CMN TCP/IP v6 socket acquired
SER1000I CMN TCP/IP environment active at 151.155.151.104..6123
SER1001I CMN TCP/IP local host name: Q001
CMN7308I CMNSTART ZMF version: 8.2.0:
CMN7300I CMNSTART Initialization in progress; @TCA=166B0000

...

SER7301I CMNSTART Loading CMN services; @ADR=00008000
SER6414I SERXMLDB Header: SERNET XML Dsect Cross Reference. Created: 2 Apr 2018 13:55:52. Version: 820
SER6415I SERXMLDB Version: 820
CMN7340I CMNSTART Loading active exits:
CMN7340I CMNSTART CMNEXINS loaded
LIC0010I Machine Seq: D5907 Type: 2965 Model: G03 Capacity: 58 MSU
LIC0013I LPAR Group: QGROUP Capacity: 56 MSU
LIC0011I LPAR ID: 05 Name: Q001 Capacity: 39 MSU
LIC0012I Licensing version: 4.3.1 Date/Time: 2018/04/19 00:48:01 Key: 9dd1f3e7
LIC0045I ChangeMan ZMF licensed to SERENA SOFTWARE UK
LIC0050I DB2 option licensed.
LIC0050I IMS option licensed.
LIC0050I Info Man option licensed.
LIC0050I Load Balance option licensed.
LIC0050I M+R option licensed.
LIC0050I Online Forms option licensed.
LIC0050I ERO option licensed.
CMN7800I CMNSTART Opened VSAM file CMNTP.S7.CMNPMAST                  Exclusive
CMN7800I CMNSTART Opened VSAM file CMNTP.S7.CMNLOG                    Exclusive
CMN7800I CMNSTART Opened VSAM file CMNTP.S7.CMNRECV                   Exclusive
CMN7800I CMNSTART Opened VSAM file CMNTP.S7.CMNCMPNT                  Exclusive
CMN7800I CMNSTART Opened VSAM file CMNTP.S7.CMNCMPNL                  Exclusive
CMN7300I CMNSTART Attach: U=CMNSTART,F1=ATTACH,F2=IADS,@TCA=18C6B000,@TCB=8BF1B0
CMN7391I CMNIAM00 Attempting to open the I/A Dataspace.
CMN7392I CMNIAM00 I/A Dataspace OPEN, LDS: CMNTP.S7.IADSP
CMN7300I CMNSTART Attach: U=CMNSTART,F1=ATTACH,F2=SSV,@TCA=18C9A000,@TCB=8A2E88
CMN7385I CMNSSV   Attempting SSV initialization CMNSSV (MVS-8.2.0:CMNSSV/6D83824E/CZMF000073) 20180322 11.13
CMN7388I CMNSSV   SSV initialization complete
CMN7300I CMNSTART Attach: U=CMNSTART,F1=ATTACH,F2=INFO,@TCA=18CB1000,@TCB=8A2890
CMN7385I CMNINFVS Attempting INFO API Connect CMNINFAP (MVS-8.2.0:CMNINFAP) 20180322 11.14 Copyright
CMN7386I CMNINFVS Unable to load BLGYSRVR - INFO API
CMN7387I CMNINFVS INFO Connection disabled
SER8600I SER#PARM dataset not updated
SER0810I SerNet server "7" initialized and ready for communications
SER0824I Attempting to load PAN#1 to determine if feature present; Please ignore any associated CSV003I message.
SER0826I PAN#1 not found
SER0824I Attempting to load LIBR to determine if feature present; Please ignore any associated CSV003I message.
SER0826I LIBR not found
CMN7300I CMNSTART Attach: U=CMNSTART,F1=ATTACH,F2=SERVDLAY,@TCA=18CBC000,@TCB=8A2600
CMN7497I CMNSTART No active HLL exits are defined, the HLLX address space will not be started.
CMN7300I CMNSTART Attach: U=CMNSTART,F1=ATTACH,F2=WKUP,@TCA=18CC7000,@TCB=8A2370
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 Exclusive
CMN7800I SERT Closed VSAM file CMNTP.S7.CMNDELAY
CMN7461I CMNDELAY - END of processing 00000
SER8209I Logon accepted for JPRESTO Usertyp=ZMF Ccsid=00037 Tca=18CD3000 UTok=4F59934B Uhwm=00001
SER0868I EPvt used=42,996K avail=1,690,636K Pvt used= 704K avail=8,488K
CMN7305I CMNSTART Detach: U=CMNSTART,F1=DETACH,F2=SERVDLAY,@TCA=18CBC000,@TCB=8A2600
CMN7303I CMNSTART Initialization Complete
SER2005I CMN Detach user JPRESTO: TCA=18CD3000 ASID=0090
SER0700I CPU ID: 00000D5907, Company: SERENA SOFTWARE UK
SER0704I Machine type: 2965, Model: G03, LPAR: Q001 / 5
SER0701I Product: 210, Name: ChangeMan ZMF (Unlimited)
SER0701I Product: 213, Name: Client Pack Usrs=0000005
SER0702I Capacity MSU: 50-59, Hours: 1
SER0705I LPAR Capacity MSU: 30-39, Hours: 1
SER0703I Report time: 2018/04/19 01:00, Hours: 1, Key: 0B7533FA

Subsystem IDs

Each SERNET instance started on an LPAR must be assigned a unique subsystem ID. If you attempt to start a SERNET instance with a subsystem ID that is the same as a SERNET instance that is already running, an error message is displayed, and the new started task is terminated.

SER0822E SerNet already active for subsystem ID "7" - Terminating
SER0999I SerNet server "7" termination complete, RC=16

Connect to the ChangeMan ZMF Primary Option Menu

You can edit ISR@PRIM in the running copy of the IBM-supplied ISPF panel library to add ChangeMan ZMF as a selection from the main ISPF menu, or you can modify your local ISPF selection menus to invoke ChangeMan ZMF.

The menu selection character invokes the ChangeMan ZMF logon CLIST that contains LIBDEF statements for concatenated ChangeMan ZMF libraries. Do not execute the ISPEXEC SELECT command for program CMNINIT directly from a panel.

If you are running multiple development and production ChangeMan ZMF instances, add a menu selection for each instance. Do not put a selection for your test ChangeMan ZMF instance on a panel available to application developers.

Stop SERNET and ChangeMan ZMF

There are several ways to bring down the SERNET started task. The recommended method is to do an orderly shutdown with a modify command that includes a grace period to allow users to end their work and logoff ChangeMan ZMF. The following table lists some variations of the shutdown command.

Shutdown Command Result
F SERs,SHUTDOWN Orderly shutdown, 5 minute default grace period
F SERs,SH Command abbreviation, same result as SHUTDOWN
F SERs,HALT+ Alternate command; same result as SHUTDOWN
F SERs,SH,M10 Orderly shutdown, 10 minute grace period
F SERs,SH,30 Orderly shutdown, 30 minute grace period
F SERs,SH,0 Immediate orderly shutdown, 15 second maximum wait

  • SERs is the started task procedure name, the started task identifier, or the JOBNAME specified on the START command. See SERNET Started Task Names for more information.

  • The keyword SHUTDOWN may be abbreviated SH.

  • The keyword HALT is equivalent to SHUTDOWN and is provided because IBM® NetView® often uses HALT as the directive to bring down long running systems.

  • The default grace period is 5 minutes.

  • Minutes of grace period may be preceded with M to conform with other hour and minute designations.

  • Grace periods longer than 30 minutes are set back to 30 minutes.

Note

If you specify a grace period, that grace period is only used if there are one or more users signed on to the started task. If the grace period expires and the users have not signed out, they will be gracefully detached and the started task will terminate. However, if the users sign out before the grace period expires, the started task will shut down immediately after the last user signs out and not wait for the full grace period that is specified.

Other methods may be used to stop the SERNET started task if the SHUTDOWN command is not successful.

Command Result
P SERs Purge all users in session immediately and stop
F SERs,ABEND Abend the started task with an S0C3 after closing VSAM files.
CANCEL SERs,DUMP Cancel the job. Caution! CANCEL is not recommended because there may be open dialogs along the network and open data sets. Severe damage could result depending on what is occurring at the time this command is executed