You should code a z/OS® Communications Server start procedure and save it in SYS1.PROCLIB. The system operator specifies the procedure when starting z/OS Communications Server.

The start procedure is called NET. The name NET is not required but is strongly recommended for consistency in entering the z/OS Communications Server operator commands and to reduce the operator’s chances of making a syntax error. The procedure name you specify must be the first operand on the START, and MODIFY operator commands. For DISPLAY, HALT, and VARY the procedure name is always NET.

//NET      PROC
//VTAM     EXEC PGM=ISTINM01,TIME=1440,REGION=4096K,
//STEPLIB  DD   DSN=SYS1.SSPLIB,DISP=SHR
//FFSTLIB  DD   DSN=SYS1.VTAMLIB,DISP=SHR
//VTAMLST  DD   DSN=SYS1.VTAMLST,DISP=SHR
//         DD   DSN=USER1.AUTO.VTAMLST,DISP=SHR
//SISTCLIB DD   DSN=SYS1.SISTCLIB,DISP=SHR
//AUTOCKPT DD   DSN=VSAM.AUTOCKPT,AMP=AMORG,DISP=OLD
//VTAMLIB  DD   DSN=SYS1.VTAMLIB,DISP=SHR
//NCPDUMP  DD   DSN=SYS1.NCPDUMP,DISP=SHR
//* DATA SETS FOR APPN DATABASE CHECKPOINTING
//DSDB1    DD   DSN=SYS1.DSDB1,DISP=SHR
//DSDB2    DD   DSN=SYS1.DSDB2,DISP=SHR
//DSDBCTRL DD   DSN=SYS1.DSDBCTRL,DISP=SHR
//TRSDB    DD   DSN=SYS1.TRSDB,DISP=SHR
//* DATA SETS 3720, 3725, AND 3745 DUMPS
//LDRIOTAB DD   DSN=SYS1.LDRIOTAB,DISP=(SHR,PASS,KEEP)
//CSPDUMP  DD   DSN=SYS1.CDUMP,DISP=SHR
//MOSSDUMP DD   DSN=SYS1.MDUMP,DISP=SHR
//NCPLOAD  DD   DSN=SYS1.NCPLOAD,DISP=SHR
//* NODELST DATA SET
//NODLST1  DD   DSN=VSAM.NODLST1,AMP=AMORG,DISP=OLD
//* ALTERNATE NODELST DATA SET
//NODLST2  DD   DSN=VSAM.NODLST2,AMP=AMORG,DISP=OLD
//* RESTART DATA SET
//* CMIP services Data Sets
//ISTCMIP  DD   DSN=SYS1.SISTCMIP,DISP=SHR
//ACYGDMO  DD   DSN=SYS1.SISTGDMO(ACYGDMO),DISP=SHR
//ISTASN1  DD   DSN=SYS1.SISTASN1,DISP=SHR

The previous example is based on the following assumptions:

• The node is APPN capable.
• A communication controller is in the network.
• The generated NCP and RRT modules for the communication controller reside in data set SYS1.NCPLOAD (NCPLOAD DD statement). The NCP source is in SYS1.VTAMLST.
• The SSP modules needed to load and dump the communication controllers are in SYS1.SSPLIB (STEPLIB DD statement).
• A dump data set is needed for the communication controller (NCPDUMP DD statement).
• The dynamic configuration of channel-attached devices facility (dynamic I/O) is being used (VTAMLST DD and AUTOCKPT DD statements).
• A dump data set is needed for the communication scanner processor (CSP) (CSPDUMP DD statement). For 3380 DASD, this data set should be allocated with at least 7 cylinders using a block size of 512.
• A dump data set is needed for the maintenance and operator subsystem (MOSS) (MOSSDUMP DD statement). For 3380 DASD, this data set should be allocated with at least 10 cylinders using a block size of 512.
• Two NODELST data sets have been defined and can be used by z/OS Communications Server (NODEDS1 DD and NODEDS2 DD statement).
• The following CMIP services have been defined (these data sets are required to enable CMIP services and the z/OS Communications Server topology agent):
  • SYS1.SISTCMIP
  • SYS1.SISTGDMO(ACYGDMO)
  • SYS1.SISTASN1
  The directory definition file in the SYS1.SISTCMIP data set can be updated while z/OS Communications Server is running, but CMIP services is aware of these changes only when:

  • The MODIFY TABLE command is issued.
  • CMIP services is restarted by one of the following methods:
    • If CMIP services is active, stop CMIP services by issuing the MODIFY VTAMOPTS command with the OSIMGMT=NO start option and then restart CMIP services by issuing the MODIFY VTAMOPTS command with the OSIMGMT=YES start option.
    • Restart z/OS Communications Server with the OSIMGMT=YES start option.

    It is recommended that you keep backup copies of both the original directory definition file (or the last directory definition file that loaded without error) and the edited version of the file. When you load the edited file, z/OS Communications Server writes over the existing version of the directory definition file. There is no way to display the contents of the file being used by CMIP services, because the file is read into an internal data structure.

    If the edited file has a syntax error, z/OS Communications Server does not use it. Message IST1444I is issued to indicate what is wrong with the file. z/OS Communications Server continues to use the last correct file that it read.

    With your backup copies, you can correct the syntax error in the edited file by comparing it to the previous file that loaded without error.

    Note: The member name, ACYDDF, must not be changed.
• Space has been allocated for all data sets, and they have been cataloged.