Skip to Content
IBM Z System Automationv4.3Installation
🌐 This page was auto-translated from Spanish

System Automation 4.3 - Installation

To perform the installation, we will follow the IBM documentation:

https://www.ibm.com/docs/en/z-system-automation/4.3.0?topic=guide-installation-configuration 

These first steps I am going to do are optional and are applicable to the ADCD system.

I do them to have the software on a specific disk and be able to reuse it on other systems:

  • Create a new disk
  • Create a catalog for that disk
  • Create an ALIAS that points to that catalog
  • Copy the System Automation software from the original disk to the new disk

COPY SOFTWARE (Optional)

Create a new disk

In my case, a model 3 is sufficient:

alcckd /mnt/1TB2/ADCD/3.1_B_acc/SA4300 -d3390-3

Emuframe image

It can be mounted dynamically.

awsmount 0AA8 -m /mnt/1TB2/ADCD/3.1_B_acc/SA4300

Emuframe image

On the z/OS system, we put the device offline:

V 0AA8,OFFLINE

Emuframe image

With a job similar to this, we initialize the disk as NO-SMS:

//IBMUSERC JOB (20,FB3),'INIT NO SMS DASD',COND=(0,NE), // CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID //ICKDSF EXEC PGM=ICKDSF,REGION=4096K //SYSPRINT DD SYSOUT=* //SYSIN DD * INIT UNITADDRESS(0AA8) NOVERIFY VOLID(SA4300) PURGE - VTOC(0,1,149) INDEX(15,0,100) /*

We respond to the reply generated by this job:

01,U

It completes successfully.

Emuframe image

We put the disk online:

V 0AA8,ONLINE

Emuframe image

In option 3.4 we verify that it is accessible and properly defined.

Emuframe image

Create catalog on the disk

You can use the following job. You only need to specify the disk in the SET P1='SA4300' parameter:

//IBMUSERC JOB (20,FB3),'JOB',COND=(0,NE), // CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID //E1 EXPORT SYMLIST=(P1) // SET P1='SA4300' //DEFMCAT EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //CATVOL1 DD UNIT=3390,VOL=SER=&P1.,DISP=SHR //SYSIN DD *,SYMBOLS=JCLONLY DEFINE USERCATALOG ( - NAME(USERCAT.V&P1. ) - VOLUME(&P1.) - ICFCATALOG - CYL (1 1) - SHAREOPTIONS(3 4) - STORCLAS(SCNOSMS) - NWCK NOIMBED NOREPLICATE)

Emuframe image

It will complete successfully.

Emuframe image

We will have the catalog defined.

Emuframe image

If we want to disconnect a catalog from the system, we use the job:

//IBMUSERC JOB (20,FB3),'JOB',COND=(0,NE), // CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID //E1 EXPORT SYMLIST=(P1) // SET P1='SA4300' //DEFMCAT EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //CATVOL1 DD UNIT=3390,VOL=SER=&P1.,DISP=SHR //SYSIN DD *,SYMBOLS=JCLONLY EXPORT USERCAT.V&P1. DISCONNECT

If we accidentally disconnect this catalog from the system, we can reconnect it with this job that performs “IMPORT CONNECT”:

//IMPORTCN JOB (20,FB3),'IMPORT',COND=(0,NE), // CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID //STEP1 EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * IMPORT - OBJECTS - ((USERCAT.VSA4300 - VOLUME(SA4300) - DEVICETYPE(3390))) - CONNECT - CATALOG(CATALOG.Z31B.MASTER) /*

Create ALIAS pointing to that catalog

We use a job like this to define an ALIAS for System Automation:

//IBMUSERC JOB (20,FB3),'JOB',COND=(0,NE), // CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID //* DEFINE ALIAS //PASO001 EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DEFINE ALIAS (NAME(SA430) - RELATE(USERCAT.VSA4300)) - CATALOG(CATALOG.Z31B.MASTER) /*

Emuframe image

We will have the ALIAS “SA430” defined.

Emuframe image

We use a job like this to define an ALIAS for NetView.

In the ADCD system, the original libraries are called NET640 and since there is already an installation of this product called NETVIEW, I will use NETVW64 for the ALIAS.

//IBMUSERC JOB (20,FB3),'JOB',COND=(0,NE), // CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID //* DEFINE ALIAS //PASO001 EXEC PGM=IDCAMS //SYSPRINT DD SYSOUT=* //SYSIN DD * DEFINE ALIAS (NAME(NETVW64) - RELATE(USERCAT.VSA4300)) - CATALOG(CATALOG.Z31B.MASTER) /*

Emuframe image

Now that we have the ALIAS, optionally, we can create a dataset to store the jobs we have been running (and those we will run later). This way, we have everything in the same library and on the same disk.

Emuframe image

We make sure the library is on the disk and in the catalog we created.

Emuframe image

Copy the System Automation software

I will use ADRDSSU to copy the TARGET libraries (AUT430.SING*) to the new disk with the HLQ of the ALIAS we created earlier (SA430).

The list of TARGET libraries can be found in the Program Directory document:

https://www.ibm.com/docs/en/z-system-automation/4.3.0?topic=program-directory 

//IBMUSERC JOB (20,FB3),'JOB',COND=(0,NE), // CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID,REGION=0M //STEPS01 EXEC PGM=ADRDSSU //SYSPRINT DD SYSOUT=* //SYSIN DD * COPY DATASET(INC(AUT430.SING*)) - OUTDYNAM ( (SA4300) ) - RENAMEU((AUT430.**,SA430.**)) - STORCLAS(SCNOSMS) - SHR - TOL(ENQF) - ALLDATA(*) - RECATALOG(USERCAT.VSA4300) /*

Emuframe image

The result will be something similar to this:

1PAGE 0001 5695-DF175 DFSMSDSS 3.1 DATA SET SERVICES 2026.002 16:13 - COPY DATASET(INC(AUT430.SING*)) - OUTDYNAM ( (SA4300) ) - RENAMEU((AUT430.**,SA430.**)) - STORCLAS(SCNOSMS) - SHR - TOL(ENQF) - ALLDATA(*) - RECATALOG(USERCAT.VSA4300) ADR101I (R/I)-RI01 (01), TASKID 001 HAS BEEN ASSIGNED TO COMMAND 'COPY ' ADR109I (R/I)-RI01 (01), 2026.002 16:13:17 INITIAL SCAN OF USER CONTROL STATEMENTS COMPLETED ADR016I (001)-PRIME(01), RACF LOGGING OPTION IN EFFECT FOR THIS TASK 0ADR006I (001)-STEND(01), 2026.002 16:13:17 EXECUTION BEGINS 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGZFS ALLOCATED WITH NEWNAME SA430.SINGZFS, IN CATALOG USERCAT.VSA4300, ON VOLUME(S): SA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGDMAP ALLOCATED WITH NEWNAME SA430.SINGDMAP, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGDMAP HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGINST ALLOCATED WITH NEWNAME SA430.SINGINST, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGINST HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGLINK ALLOCATED WITH NEWNAME SA430.SINGLINK, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGLINK HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGLOAD ALLOCATED WITH NEWNAME SA430.SINGLOAD, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGLOAD HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGLODE ALLOCATED WITH NEWNAME SA430.SINGLODE, ON VOLUME(S): SA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGLPA ALLOCATED WITH NEWNAME SA430.SINGLPA, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGLPA HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGMENU ALLOCATED WITH NEWNAME SA430.SINGMENU, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGMENU HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGMENV ALLOCATED WITH NEWNAME SA430.SINGMENV, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGMENV HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGMJPN ALLOCATED WITH NEWNAME SA430.SINGMJPN, ON VOLUME(S): SA4300 0ADR744W (001)-MRPAM(01), NO VALID MEMBERS WERE FOUND FOR PDS DATA SET AUT430.SINGMJPN. ONLY THE DIRECTORY WILL BE UPDATED 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGMJPN HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGOBJV ALLOCATED WITH NEWNAME SA430.SINGOBJV, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGOBJV HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 1PAGE 0002 5695-DF175 DFSMSDSS 3.1 DATA SET SERVICES 2026.002 16:13 -ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGPARM ALLOCATED WITH NEWNAME SA430.SINGPARM, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGPARM HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGPDB ALLOCATED WITH NEWNAME SA430.SINGPDB, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGPDB HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGPENU ALLOCATED WITH NEWNAME SA430.SINGPENU, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGPENU HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGPJPN ALLOCATED WITH NEWNAME SA430.SINGPJPN, ON VOLUME(S): SA4300 0ADR744W (001)-MRPAM(01), NO VALID MEMBERS WERE FOUND FOR PDS DATA SET AUT430.SINGPJPN. ONLY THE DIRECTORY WILL BE UPDATED 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGPJPN HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGPRF ALLOCATED WITH NEWNAME SA430.SINGPRF, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGPRF HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGREXV ALLOCATED WITH NEWNAME SA430.SINGREXV, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGREXV HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGREXX ALLOCATED WITH NEWNAME SA430.SINGREXX, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGREXX HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGSAMP ALLOCATED WITH NEWNAME SA430.SINGSAMP, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGSAMP HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGSENU ALLOCATED WITH NEWNAME SA430.SINGSENU, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGSENU HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGTENU ALLOCATED WITH NEWNAME SA430.SINGTENU, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGTENU HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR395I (001)-NEWDS(01), DATA SET AUT430.SINGTREX ALLOCATED WITH NEWNAME SA430.SINGTREX, ON VOLUME(S): SA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGTREX HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR465I (001)-CNVSM(01), DATA SET SA430.SINGLODE HAS BEEN CATALOGED IN CATALOG USERCAT.VSA4300 0ADR801I (001)-DDDS (01), 2026.002 16:13:21 DATA SET FILTERING IS COMPLETE. 22 OF 22 DATA SETS WERE SELECTED: 0 FAILED SERIALIZATION AND 0 FAILED FOR OTHER REASONS 0ADR454I (001)-DDDS (01), THE FOLLOWING DATA SETS WERE SUCCESSFULLY PROCESSED 0 AUT430.SINGZFS 0 AUT430.SINGDMAP 1PAGE 0003 5695-DF175 DFSMSDSS 3.1 DATA SET SERVICES 2026.002 16:13 - AUT430.SINGINST 0 AUT430.SINGLINK 0 AUT430.SINGLOAD 0 AUT430.SINGLODE 0 AUT430.SINGLPA 0 AUT430.SINGMENU 0 AUT430.SINGMENV 0 AUT430.SINGMJPN 0 AUT430.SINGOBJV 0 AUT430.SINGPARM 0 AUT430.SINGPDB 0 AUT430.SINGPENU 0 AUT430.SINGPJPN 0 AUT430.SINGPRF 0 AUT430.SINGREXV 0 AUT430.SINGREXX 0 AUT430.SINGSAMP 0 AUT430.SINGSENU 0 AUT430.SINGTENU 0 AUT430.SINGTREX 0ADR006I (001)-STEND(02), 2026.002 16:13:21 EXECUTION ENDS 0ADR013I (001)-CLTSK(01), 2026.002 16:13:21 TASK COMPLETED WITH RETURN CODE 0004 0ADR012I (SCH)-DSSU (01), 2026.002 16:13:21 DFSMSDSS PROCESSING COMPLETE. HIGHEST RETURN CODE IS 0004 FROM: TASK 001

Verify that we have all the datasets copied.

Emuframe image

Emuframe image

Copy the NetView software

I will use ADRDSSU to copy the TARGET libraries. In this case, you need to select the TARGET libraries specifically, because many cannot be grouped as with System Automation. The HLQ will be the ALIAS we created earlier (NETVW64).

The list of TARGET libraries can be found in the Program Directory document:

https://www.ibm.com/docs/en/z-netview/6.4.0?topic=640-z-netview-program-directory 

//IBMUSERC JOB (20,FB3),'JOB',COND=(0,NE), // CLASS=A,MSGCLASS=H,NOTIFY=&SYSUID,REGION=0M //STEPS01 EXEC PGM=ADRDSSU //SYSPRINT DD SYSOUT=* //SYSIN DD * COPY DATASET(INC( - NET640.BNJPNL1 - NET640.BNJPNL2 - NET640.BNJSRC1 - NET640.CNMCLST - NET640.CNMINST - NET640.CNMLINK - NET640.CNMPNL1 - NET640.CNMSAMP - NET640.DSIPARM - NET640.DSIPRF - NET640.NVULIB - NET640.SAQN* - NET640.SCNM* - NET640.SDSI* - NET640.SDUIMSG1 - NET640.SEKGLANG - NET640.ZFS - )) - OUTDYNAM ( (SA4300) ) - RENAMEU((NET640.**,NETVW64.**)) - STORCLAS(SCNOSMS) - SHR - TOL(ENQF) - ALLDATA(*) - RECATALOG(USERCAT.VSA4300) /*

Emuframe image

Verify that we have the datasets created:

Emuframe image

Emuframe image

BEGIN INSTALLATION

CONFWRK Library

To perform the installation, follow these steps:

https://www.ibm.com/docs/en/z-system-automation/4.3.0?topic=sazos-preparing-configure-system-automation 

You need to create a library for the configuration that does not exceed 35 characters with the LLQ “CONFWRK”. It must follow this pattern:

hlq.saplex.CONFLIB

Here is a JCL to create it:

//$02CONF JOB CLASS=A,MSGCLASS=Q,MSGLEVEL=(1,1),NOTIFY=&SYSUID, // REGION=0M //IDCAMS EXEC PGM=IDCAMS //CONFWRK DD DSN=SA430.ADCDPL.CONFWRK, // DISP=(NEW,CATLG,DELETE), // UNIT=3390,SPACE=(TRK,(15,5,5)), // STORCLAS=SCNOSMS,VOL=SER=SA4300, // DCB=(DSORG=PO,BLKSIZE=27920,LRECL=80,RECFM=FB) //SYSPRINT DD SYSOUT=* //SYSIN DD DUMMY

Emuframe image

Emuframe image

Now we copy the members INGDOPT and INGDCONF from the .SINGSAMP library to the library we just created (.CONFWRK).

Emuframe image

Emuframe image

Edit INGDOPT

Here I leave the detail of the configuration I will use. I have tried to leave most of it as default.

The INGDOPT member includes detailed documentation about each parameter.

For PROCs and STCs I have tried to group them under “ING*”.

Some optional features I will not use. Others, I will configure in the future, such as “Service Management Unite (SMU) console connection” (parameter: sa_e2e_smu_ip).

In “sys_sms_managed_datasets”, I am going to indicate “NO” because I want to create the datasets on the NO-SMS disk (SA4300), but, in the case of the ADCD version, it is necessary to indicate the STORCLAS “SCNOSMS” so that it treats them as NO-SMS.

Since the process will not automatically add STORCLAS(SCNOSMS), we will have to edit the job manually.

It is possible that other modifications will need to be made later.

sys_jobcard_1=//ING<Ñ4:8> JOB 'SA Z/OS-CONFIG', sys_jobcard_2=// CLASS=A,MSGCLASS=X,MSGLEVEL=(1,1), sys_jobcard_3=// REGION=256M,NOTIFY=&SYSUID sys_sysname=S0W1 sys_jes_name=JES2 net_netview_domain_id=SA01 net_netview_taf_id=01 net_netview_majnode=MNING01 sa_hlq_smpe=SA430 nv_hlq_smpe=NETVW64 sa_usspath_smpe=/usr/lpp/ing sa_hlq_user=SA430.SA00 sa_usspath_user=/var/ing sys_sms_managed_datasets=NO sys_sms_storclas=SCNOSMS sys_sms_mgmtclas= sys_sms_dataclas= sys_dataset_unit=3390 sys_dataset_volser=SA4300 sys_hlq_sclbdll=CBC sys_hlq_sceerun=CEE sys_parmlib_suffix=SA sa_xcf_grpid_suffix=SA sa_xcf_plexid_suffix=00 sa_automation_policy=SA430.$POLICY.S0W1.PDB sa_am_start_proc=INGEAMSA sa_am_start_job.1=INGAM sa_am_start_job.2=INGAM2 sa_saagent_start_proc=INGENVSA sa_saagent_start_job=INGNVSA sa_nvssi_start_proc=INGESSI sa_nvssi_start_job=INGNVSSI sa_ipldata_start_proc=INGEIPLC sa_ipldata_start_job=INGIPLC sys_tws_hlq_smpe=TWS sys_tws_mlog_ds=TWS.V101A.MLOG sys_cpsm_hlq_smpe= nv_eas_start_proc=IHSAEVNT nv_eas_eif_start_job=EIFAEVNT nv_eas_eif_init_file=EIFINIT nv_eas_eif_messagea_file=EIFMCFG nv_eas_eif_ppi_name=INGEVOMN nv_eas_eif_rec_host= nv_eas_eif_rec_port=0 sa_e2e_smu_ip= sa_e2e_agent_location= net_e2e_agent_ip= sa_usspath_user_e2e=adapter sys_java_usspath_smpe=/usr/lpp/java/J17.0_64 sa_e2eagnt_start_proc=INGXEAGT sa_e2eagnt_start_job=E2EAGENT net_e2eagnt_rec_port=2003 sa_e2eadpt_start_proc=INGXADPT sa_e2eadpt_start_job=E2EADPT net_e2eadpt_snd_port=2002 net_e2eadpt_rec_port=2001 nv_eas_e2e_start_job=E2EEAS nv_eas_e2e_init_file=E2EINIT nv_eas_e2e_messagea_file=E2EMCFG nv_eas_e2e_rec_port=5529 racf_group_auto=INGAUTO racf_omvs_gid_auto=80004 racf_omvs_uid=90004 racf_omvs_home=/u/autooper racf_group_autowrk=INGWRK racf_omvs_gid_autowrk=80006 racf_group_user=INGUSER racf_omvs_gid_user=80001 racf_group_oper=INGOPER racf_omvs_gid_oper=80002 racf_group_admin=INGADMIN racf_omvs_gid_admin=80003 racf_group_super=INGSUPER racf_omvs_gid_super=80005

Emuframe image

Edit and execute INGDCONF

In the job, the only thing you need to edit are the values of the “SET …” variables with the data we have defined previously. Then execute the job.

//INGDCONF JOB CLASS=A,MSGCLASS=Q,MSGLEVEL=(1,1),NOTIFY=&SYSUID, // REGION=0M // SET SAPLEX=ADCDPL // SET HLQCONF=SA430 // SET DASDDEF='STORCLAS=SCNOSMS,UNIT=3390,VOL=SER=SA4300' // SET HLQSMPSA=SA430 // SET HLQSMPNV=NETVW64 // SET OPTSMEM=INGDOPT // SET CONFWRK=&HLQCONF..&SAPLEX..CONFWRK // SET CONFLIB=&HLQCONF..&SAPLEX..CONFLIB //STEP0010 EXEC PGM=IEFBR14 //DELILIB DD DISP=(MOD,DELETE,DELETE), // DSN=&CONFLIB., // &DASDDEF., // SPACE=(TRK,(1,0,0)),LRECL=80,RECFM=FB //STEP0020 EXEC PGM=IEFBR14 //STDOUT DD DISP=(,CATLG,DELETE), // DSN=&CONFLIB., // &DASDDEF., // RECFM=FB,LRECL=80,BLKSIZE=6160, // SPACE=(CYL,(3,1,45),RLSE) //IFÑÑ0020 IF (STEP0020.RC EQ 00 OR // STEP0020.RUN EQ FALSE) THEN //STEP0030 EXEC PGM=IEBCOPY //SYSPRINT DD SYSOUT=* //IÑ1 DD DISP=SHR, // DSN=&HLQSMPSA..SINGSAMP //IÑ2 DD DISP=SHR, // DSN=&HLQSMPNV..CNMSAMP //OÑ1 DD DISP=SHR,DSN=&CONFLIB. //SYSUT3 DD UNIT=SYSALLDA,SPACE=(CYL,(5,1)) //SYSUT4 DD UNIT=SYSALLDA,SPACE=(CYL,(5,1)) //SYSIN DD * C O=OÑ1,I=IÑ1 SELECT MEMBER=(INGSALLC,INGSDEL) SELECT MEMBER=(INGSAMSA,HSASPRM) SELECT MEMBER=(INGSNVSA,INGSINIT,INGSSGEN,INGESCAT,INGSPTOP) SELECT MEMBER=(INGEPRT) SELECT MEMBER=(INGSCMD,INGSAPF,INGSLNK,INGSLPA,INGSSSN,INGSBPX) SELECT MEMBER=(INGESCH,INGSPROG,INGSSYS,INGSMPF,CTIHSAZZ) SELECT MEMBER=(INGSDLG) SELECT MEMBER=(INGSREAD) SELECT MEMBER=(INGSNET,INGSMTAB) SELECT MEMBER=(HSACTWR,HSAPIPLC,INGPIPLC,INGPHOM,INGPIXCU) SELECT MEMBER=(INGJICVM) SELECT MEMBER=(INGSJ010) SELECT MEMBER=(INGSEVNT,INGSEINT,INGSMCFG,INGMFMTO) SELECT MEMBER=(INGSADPT,INGSEAGT,INGSCE2E,INGMFMTE) SELECT MEMBER=(INGDVIPA) SELECT MEMBER=(INGSGENL,INGSSAF) C O=OÑ1,I=IÑ2 SELECT MEMBER=((CNMS0001,AMODETAB)) SELECT MEMBER=((CNMS0011,AUSSTAB)) SELECT MEMBER=((CNMS0040,ISTSDCOS)) SELECT MEMBER=((CNMS0050,INTERCOS)) /* //IFÑÑ0030 IF (STEP0030.RC EQ 00 OR // STEP0030.RUN EQ FALSE) THEN //STEP0040 EXEC PGM=IKJEFT1B,REGION=32M, // PARM='%INGRPREP INGOPTS INGCONF INGSVDT INGDSIP' //INGOPTS DD DISP=SHR, // DSN=&CONFWRK.(&OPTSMEM.) //INGCONF DD DISP=SHR, // DSN=&CONFLIB. //INGSVDT DD DISP=SHR, // DSN=&HLQSMPSA..SINGSAMP(INGDSVDT) //INGDSIP DD DISP=SHR, // DSN=&HLQSMPNV..DSIPARM(CNMSTYLE) //SYSPROC DD DISP=SHR, // DSN=&HLQSMPSA..SINGTREX @L1C //SYSTSPRT DD SYSOUT=* //SYSPRINT DD SYSOUT=* //SYSTSIN DD DUMMY //EIFÑÑ030 ENDIF Copy Member to CONFLIB //EIFÑÑ020 ENDIF Allocate new CONFLIB //

Emuframe image

Verify that it completes successfully.

Emuframe image

Emuframe image

$INGREAD Instructions

With the execution of the previous job, a series of members have been created within the **.CONFLIB library. One of them is **$INGREAD** and it contains the instructions we must follow for the installation.

Create “working datasets”

We need to execute the job INGDSALC. First, in the case of the ADCD version, I need to add the STORCLAS to each file creation so they go to the disk I want.

STORCLAS(SCNOSMS) -

Emuframe image

Verify that the job completes successfully.

Emuframe image

Verify that all datasets have been created on the desired disk.

Emuframe image

NetView DSIPARM Configuration

Since this is a new installation, you need to copy the following members from SA430.ADCDPL.CONFLIB to SA430.SA00.DSIPARM:

  • CNMSTGEN
  • INGESCAT
  • INGPTOP
  • INGXINIT

Emuframe image

Copy HSAPRMSA to PARMLIB

Copy the member HSAPRMSA (Automation Manager) from SA430.ADCDPL.CONFLIB to the PARMLIB that was created during installation (in my case, SA430.SA00.PARMLIB).

Emuframe image

Copy STCs to PROCLIB

Copy the following members to the system PROCLIB (in my case, USER.Z31B.PROCLIB):

  • INGEAMSA
  • INGENVSA
  • INGESSI
  • INGEPRT
  • INGEIPLC
  • INGPIPLC
  • INGPHOM
  • INGPIXCU

If we plan to have NetView start before JES2 (and not at the same time), we must copy INGEAMSA, INGENVSA, and INGESSI to SYS1.PROCLIB. For example, so that System Automation starts all tasks.

https://www.ibm.com/docs/en/z-netview/6.4.0?topic=initialization-starting-netview-program-before-jes 

Emuframe image

Emuframe image

Configure PARMLIB

The documentation indicates that you can copy the members to the corresponding PARMLIB and edit IEASYSxx to load those members as well, or simply copy the content to the active members. To avoid having many different files, I will copy the content to the active configuration.

BPXPRMSA

Content:

MOUNT FILESYSTEM('SA430.SINGZFS') MOUNTPOINT('/usr/lpp/ing') TYPE(ZFS) MODE(READ)

Emuframe image

COMMNDSA

Content:

COM = "S INGEAMSA,JOBNAME=INGAM,SUB=MSTR" COM = "S INGENVSA,JOBNAME=INGNVSA,SUB=MSTR" COM = "S INGESSI,JOBNAME=INGNVSSI,SUB=MSTR"

Emuframe image

IEAAPFSA

Content. I will copy this to the corresponding PROGxx member.

SA430.SINGLOAD SA430.SINGLODE SA430.SINGLINK SA430.SINGLPA NETVW64.CNMLINK NETVW64.SAQNLINK NETVW64.SCNMLNKN NETVW64.SCNMLNK1
APF ADD DSNAME(SA430.SINGLOAD) VOLUME(SA4300) APF ADD DSNAME(SA430.SINGLODE) VOLUME(SA4300) APF ADD DSNAME(SA430.SINGLINK) VOLUME(SA4300) APF ADD DSNAME(SA430.SINGLPA) VOLUME(SA4300) APF ADD DSNAME(NETVW64.CNMLINK) VOLUME(SA4300) APF ADD DSNAME(NETVW64.SAQNLINK) VOLUME(SA4300) APF ADD DSNAME(NETVW64.SCNMLNKN) VOLUME(SA4300) APF ADD DSNAME(NETVW64.SCNMLNK1) VOLUME(SA4300)

Emuframe image

IEFSSNSA

Content. In my case, the JES2 parameter is already defined the same. I will add the second one at the end (or after the JES2 definition).

Also, I already had a NetView subsystem defined. I have commented out that configuration.

/* NAME OF PRIMARY SUBSYSTEM */ SUBSYS SUBNAME(JES2) PRIMARY(YES) START(NO) /* NAME OF NETVIEW SUBSYS @01C*/ SUBSYS SUBNAME(INGN) INITRTN(DSI4LSIT) INITPARM('TINYDS')

Emuframe image

CNMLINK

Content. I will copy this to the corresponding PROGxx member.

SA430.SINGLOAD SA430.SINGLINK NETVW64.CNMLINK NETVW64.SAQNLINK NETVW64.SCNMLNKN NETVW64.SCNMLNK1
LNKLST ADD NAME(LNKLST00) DSN(SA430.SINGLOAD) VOLUME(SA4300) LNKLST ADD NAME(LNKLST00) DSN(SA430.SINGLINK) VOLUME(SA4300) LNKLST ADD NAME(LNKLST00) DSN(NETVW64.CNMLINK) VOLUME(SA4300) LNKLST ADD NAME(LNKLST00) DSN(NETVW64.SAQNLINK) VOLUME(SA4300) LNKLST ADD NAME(LNKLST00) DSN(NETVW64.SCNMLNKN) VOLUME(SA4300) LNKLST ADD NAME(LNKLST00) DSN(NETVW64.SCNMLNK1) VOLUME(SA4300)

Emuframe image

LPALSTSA

Content:

SA430.SINGLPA NETVW64.SCNMLPA1

Emuframe image

CTIHSAZZ

If it doesn’t already exist, copy it to PARMLIB.

Emuframe image

MPFLSTXX

Add the following messages to the corresponding MPFLSTxx member of the PARMLIB we are using.

This is so that only the AOF603D message is sent to AUTO and not the rest of the AOF* messages.

AOF603D is the startup reply (WTOR) for System Automation.

AOF603D,SUP(NO),RETAIN(NO),AUTO(YES) AOF*,SUP(NO),RETAIN(NO),AUTO(NO)

VERY IMPORTANT! If we have an entry like:

.NO_ENTRY,AUTO(NO)

(as shown in the image)

Emuframe image

We must change it to AUTO(YES) because if we don’t, there will be tasks that display messages that won’t be captured by this MPF LIST and won’t reach System Automation either. As a result, these tasks will remain waiting for an “UP” message that they will never receive.

.NO_ENTRY,AUTO(YES)

Emuframe image

Configure VTAM

You need to execute the member INGMTAB from the SA430.ADCDPL.CONFLIB library to create VTAM resources in the new SA430.ADCDPL.CONFLIB.VTAMLIB library.

In my case, in the DSALC step I had to add “STORCLAS=SCNOSMS,”.

//DSALC EXEC PGM=IEFBR14 //ALLOC DD DSN=SA430.ADCDPL.CONFLIB.VTAMLIB, // DISP=(NEW,CATLG,CATLG),STORCLAS=SCNOSMS, // UNIT=3390,VOL=SER=SA4300, // SPACE=(TRK,(15,15,15)),DSNTYPE=PDS, // DCB=(RECFM=U,LRECL=0,BLKSIZE=6144)

Verify that it completes successfully.

Emuframe image

We will have the following modules, of which I will only copy AMODETAB and ISTSDCOS to my active VTAMLIB (in my case, USER.Z31B.VTAMLIB). The reason is that I already have a customized AUSSTAB that I will modify later and the INTERCOS member indicates that it is optional.

To find out which VTAMLIB and VTAMLST libraries we have available, we need to look at the VTAM STC. The concatenation of libraries for both DDs will appear there.

Emuframe image

Emuframe image

Copy the member SA430.ADCDPL.CONFLIB(MNING01) to a **.VTAMLST library that we use in the system (in my case, USER.Z31B.VTAMLST).

Emuframe image

Add it to the ATCCONxx member of the **.VTAMLST library. In my case, USER.Z31B.VTAMLST(ATCCON00). This way, those nodes will be activated when VTAM starts.

Emuframe image

Configure Security - RACF

You need to execute the job SA430.ADCDPL.CONFLIB(INGGENL). This job creates a library with a job containing the RACF commands to configure all security.

I recommend putting more space in the SPACE parameter than the default.

//CNFREALC EXEC PGM=IKJEFT01,REGION=32M //SYSPROC DD DSN=SA430.SINGTREX,DISP=SHR //SYSTSIN DD * INGRRSYM DEBUG=NO TRACE=O - ACTION=EXECUTE - DDIN=REALCCMD /* //SYSTSPRT DD SYSOUT=* //REALCCMD DD * DELETE 'SA430.ADCDPL.CONFLIB.&SYSNAME.' ALLOCATE - DATASET('SA430.ADCDPL.CONFLIB.&SYSNAME.') - NEW CATALOG - VOL(SA4300) UNIT(3390) - STORCLAS(SCNOSMS) - TRACKS - DSORG(PO) - DIR(5) - SPACE(30,15,) - RECFM(F,B) - LRECL(80) - BLKSIZE(27920) /* //* //IFÑDSA IF (CNFREALC.RC EQ 00 OR // CNFREALC.RUN EQ FALSE) THEN //*------------------------------------------------------------------- //* Generate System Specific SAF command member into CONFLIB.sysname //*------------------------------------------------------------------- //SAFGENL EXEC PGM=IKJEFT01,REGION=32M //SYSPROC DD DSN=SA430.SINGTREX,DISP=SHR //SYSTSIN DD * INGRRSYM DEBUG=NO TRACE=O - DDIN=SAFDSIN - DDDROP=SAFSYM - DDOUT='SA430.ADCDPL.CONFLIB.&SYSNAME.(INGESAF)' /* //SAFDSIN DD DISP=SHR,DSN=SA430.ADCDPL.CONFLIB(INGESAF) //SAFSYM DD * &SLASHFW /* //SYSTSPRT DD SYSOUT=* //* //EIFÑDSA ENDIF Allocate Local CONFLIB DS //* //

Verify that it completes successfully.

Emuframe image

Now we will have the new library SA430.ADCDPL.CONFLIB.sysname (in my case, SA430.ADCDPL.CONFLIB.S0W1). Inside we will have the job to configure RACF.

VERY IMPORTANT. Review that job carefully before executing. It is better to execute the commands little by little and only those we need.

Some changes I had to make.

To avoid this error:

https://www.ibm.com/docs/en/zos/3.1.0?topic=messages-irr52174i 

IRR52174I Incorrect UID 90004. This value is already in use by AUTINIT1.

C '(UID(90004) +' '(UID(90004) SHARED +'

To avoid the error when creating generic dataset profiles with double asterisk ”**”:

IKJ56702I INVALID DATASET NAME, ‘SA430.**’

Enhanced Generic Naming

https://www.ibm.com/docs/en/zos/3.1.0?topic=pnds-generic-profile-rules-when-enhanced-generic-naming-is-active 

SETROPTS EGN

Emuframe image

IMPORTANT: When reviewing the job output, we should not just check that it ends with RC=00. This only indicates that the RACF commands were executed. We must review the complete output to see the errors that may have appeared from the commands.

In my case, I got this error for some users. This seems to be because the RACF DB has run out of space. To correct it, I should get a list of the users that gave this error, expand the RACF DB, and run the commands again.

ICH51013I PROFILE ADDED OR ALTERED BUT NO ROOM TO MAKE ALIAS INDEX ENTRY.

Emuframe image

Create directories - MKDIR

Finally, we must create the directories in OMVS that we have defined in the configuration. This can be done with this job:

//$05MKDIR JOB CLASS=A,MSGCLASS=Q,MSGLEVEL=(1,1),NOTIFY=&SYSUID, // REGION=0M //MKDIR EXEC PGM=IKJEFT1A //SYSTSPRT DD SYSOUT=* //STDOUT DD SYSOUT=* //STDERR DD SYSOUT=* //SYSTSIN DD * BPXBATCH SH mkdir -p /u/autooper BPXBATCH SH mkdir -p /var/ing

Emuframe image

Verify that it completes successfully.

Emuframe image

Optional - SMF Record 114

You can add SMF record 114 for availability reports.

https://www.ibm.com/docs/en/z-system-automation/4.3.0?topic=members-step-4i-update-smfprmxx 

In my case, all are captured except type 99.

Emuframe image

Final changes before IPL

I will explain some previous modifications that will help resolve some errors on the first startup.

STC - INGEAMSA

The first startup must be with TYPE=COLD to format the files.

Emuframe image

In the parameter file used by the INGEAMSA STC, SA430.SA00.PARMLIB(HSAPRMSA), disable the LOG STREAM (LOGSTREAM=NO).

Emuframe image

STC - INGENVSA

For this STC I set the LOGSTREAM=NO parameter in its DSIPARM configuration file because, for now, I am not going to use it.

Emuframe image

In my case: SA430.SA00.DSIPARM(INGXINIT)

Emuframe image

Modify IEASYMxx

We must add the following symbols to the IEASYMxx file we are using. You can see it with the D IPLINFO command.

CNMDOMN is the domain we configured in the INGDOPT member.

CNMTCPN is the TCPIP name.

CNMNETID is the network name.

SYMDEF(&CNMDOMN='SA01') SYMDEF(&CNMTCPN='TCPIP') SYMDEF(&CNMNETID='NETD')

Emuframe image

RACF - Additional Permissions

In the ADCD system, these RACF errors will appear when the INGNVSA task starts:

RO T=28,*ALL,D IPLINFO IEE345I ROUTE AUTHORITY INVALID, FAILED BY SECURITY PRODUCT ICH408I USER(START1 ) GROUP(SYS1 ) NAME(ÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑ) 011 MVS.ROUTE.CMD.ALLSYSTEMS CL(OPERCMDS) INSUFFICIENT ACCESS AUTHORITY FROM MVS.ROUTE.CMD.* (G) ACCESS INTENT(READ ) ACCESS ALLOWED(NONE ) ICH408I USER(AUTINIT1) GROUP(INGAUTO ) NAME(ÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑ) 969 MVS.MCSOPER.AINIT1W1 CL(OPERCMDS) INSUFFICIENT ACCESS AUTHORITY FROM MVS.MCSOPER.* (G) ACCESS INTENT(READ ) ACCESS ALLOWED(NONE ) AOF206I 11:10:24 : "MVS DISPLAY TIME" COMMAND FAILED FOR AOFRANTL 970 : RECEIVED "DWO521I TASK AUTINIT1 IS NOT AUTHORIZED BY THE SECURITY SOFTWARE TO OBTAIN EXTENDED CONSOLE AINIT1W1 " ICH408I USER(AUTINIT1) GROUP(INGAUTO ) NAME(ÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑÑ) 148 MVS.DISPLAY.TIMEDATE CL(OPERCMDS) INSUFFICIENT ACCESS AUTHORITY FROM MVS.DISPLAY.* (G) ACCESS INTENT(READ ) ACCESS ALLOWED(NONE ) AOF206I 11:25:27 : "MVS DISPLAY TIME" COMMAND FAILED FOR AOFRANTL 149 : RECEIVED "IEE345I DISPLAY AUTHORITY INVALID, FAILED BY SECURITY PRODUCT "

Issue the following commands to assign the correct permissions:

PERMIT MVS.ROUTE.CMD.* CLASS(OPERCMDS) ID(SYS1) ACCESS(READ) PERMIT MVS.MCSOPER.* CLASS(OPERCMDS) ID(INGAUTO) ACCESS(READ) PERMIT MVS.DISPLAY.* CLASS(OPERCMDS) ID(INGAUTO) ACCESS(READ) Other commands to prevent errors when starting System Automation with automation enabled: PERMIT MVS.ROUTE.CMD.* CLASS(OPERCMDS) ID(INGAUTO) ACCESS(READ) PERMIT MVS.CANCEL.STC.* CLASS(OPERCMDS) ID(INGAUTO) ACCESS(UPDATE) PERMIT MVS.START.STC.* CLASS(OPERCMDS) ID(INGAUTO) ACCESS(UPDATE) PERMIT MVS.MODIFY.STC.* CLASS(OPERCMDS) ID(INGAUTO) ACCESS(UPDATE) PERMIT MVS.STOP.STC.* CLASS(OPERCMDS) ID(INGAUTO) ACCESS(UPDATE) PERMIT MVS.* CLASS(OPERCMDS) ID(INGAUTO) ACCESS(UPDATE) Refresh configuration: SETROPTS RACLIST(OPERCMDS) REFRESH

Emuframe image

Emuframe image

In the NetView configuration member, you need to enable SAF authentication (RACF in my case) so we can access the product.

In my case, I need to edit SA430.SA00.DSIPARM(CNMSTGEN) to modify and add the following:

SECOPTS.OPERSEC = SAFDEF *SECOPTS.OPERSEC = SAFPW SECOPTS.CMDAUTH = SAF.PASS *SECOPTS.CMDAUTH = TABLE.INGESCAT To avoid errors, add: SECOPTS.OPSPAN = SAF

Emuframe image

Then we need to connect personal users to one of the groups we defined in RACF (according to the access level they should have): INGSUPER, INGADMIN, INGOPER, INGUSER

In my case, I want all permissions:

CONNECT IBMUSER GROUP(INGSUPER)

Assign jobID to the INGNVSA STC - DSIRQJOB

DSIRQJOB is an internal NetView task that assigns a jobID to the “INGNVSA” STC when we start with “SUB=MSTR” and allows us to see part of the joblog from SDSF to detect errors. By default, it is disabled.

To enable it:

We copy the CNMSTYLE member from the TARGET NetView DSIPARM library to our library where we are making modifications.

Emuframe image

In my case, from NETVW64.DSIPARM(CNMSTYLE) to SA430.SA00.DSIPARM

Emuframe image

We locate the following line and comment it out:

*TASK.DSIRQJOB.MOD=*NONE*

Emuframe image

We set the TASK.DSIRQJOB.INIT parameter to Yes so that the internal NetView task DSIRQJOB starts:

TASK.DSIRQJOB.INIT = Y

Emuframe image

When we do an IPL and NetView starts, we can verify that this task is active with the commands:

LIST DSIRQJOB TASKUTIL DSIRQJOB

Emuframe image

To be able to start NetView completely before JES2 and have a jobID assigned later, we must meet the requirements indicated here:

https://www.ibm.com/docs/en/z-netview/6.4.0?topic=initialization-starting-netview-program-before-jes 

The documentation states:

• All data sets must be referenced by VOL=SER or be cataloged in the master catalog.

If you have followed this installation, we do not have the datasets cataloged in the master catalog. I have not yet tested if it is necessary, but I leave the modified STC with the parameters included:

//INGENVSA PROC PROG=DSIMNT, //* ** NETVIEW DOMAIN NAME // DOMAIN=SA01, //* ** GROUPID AS PART OF THE NAME OF //* SA PLEX SHARED DATASETS // GRPID=SA, //* ** USER DSN HIGH LEVEL QUALIFIER // Q1=SA430.SA00, //* ** NETVIEW DSN HIGH LVL QUALIFIER // SQ1=NETVW64, //* ** SA z/OS DSN HIGH LVL QUALIFIER // SQ2=SA430, //* ** VSAM DSN HIGH LVL QUALIFIER // VQ1=SA430.SA00, //* ** SA z/OS DSN HIGH LVL QUALIFIER-VSAM // VQ2=SA430.SA00, //* ** IWS DSN HIGH LVL QUALIFIER // EQQ=TWS, //* ** IWS MLOG DS NAME OF LOCAL TRACKER // EQQMLOG=TWS.V101A.MLOG, //* Comment out the following symbolic if starting NetView before JES //* SOUTA='*', ** Default printed output class // REG=0, ** Region Size(Im MB) for NetView // SUBSYM='', ** Symbolic substitution switch //* ** *SUBSYM = enable symbolic substitution //* ** *NOSUBSYM = disable symbolic //* ** substitution //* ** Default option: *SUBSYM // NV2I='', //* ** UNIQUE AID A two character value //* ** used to build a symbolic in SA z/OS //* ** If you specify a value, you MUST //* ** rename/copy CNMSTYLE to CxxSTYLE //* ** to match. //* ** Default Value: NM // TRSIZE='' //* ** INTERNAL TRACE TABLE SIZE - Number //* ** of pages to be allocated for the //* ** NetView Internal Trace tablewhich is //* ** located in a data space. //* ** Valid Range: 0-524286 //* ** Default Value: 4000 //* ** If a value of 0 is passed, internal //* ** trace is not started early. //* ** Trace options in CNMSTYLE take effect //* ** even if trace is not started early. //* //********************************************************************** //NETVIEW EXEC PGM=&PROG,TIME=1440, // REGION=&REG.M, // PARM=(24K,200, // '&DOMAIN','','','&SUBSYM','&NV2I','&TRSIZE'), // DPRTY=(13,13) //DSICLD DD DSN=&Q1..CNMCLST,DISP=SHR, USER TARGET // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ2..SINGREXX,DISP=SHR, SA TARGET @L2C // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ1..SAQNCLST,DISP=SHR, NETVIEW TARGET // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ1..CNMCLST,DISP=SHR, NETVIEW TARGET // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ1..CNMSAMP,DISP=SHR, NETVIEW SAMPLIB // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //DSIOPEN DD DSN=&SQ1..SDSIOPEN,DISP=SHR, // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //DSIPARM DD DSN=&Q1..&DOMAIN..DSIPARM,DISP=SHR, USER TARGET // UNIT=3390,VOL=SER=SA4300 // DD DSN=&Q1..DSIPARM,DISP=SHR, USER TARGET // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ2..SINGPARM,DISP=SHR, SA TARGET @L2C // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ1..SAQNPARM,DISP=SHR, NETVIEW TARGET // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ1..DSIPARM,DISP=SHR, NETVIEW TARGET // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //DSILIST DD DSN=&Q1..&DOMAIN..DSILIST,DISP=SHR, USER TARGET // UNIT=3390,VOL=SER=SA4300 //DSIASRC DD DSN=&Q1..&DOMAIN..DSIASRC,DISP=SHR, USER TARGET // UNIT=3390,VOL=SER=SA4300 //DSIARPT DD DSN=&Q1..&DOMAIN..DSIARPT,DISP=SHR, USER TARGET // UNIT=3390,VOL=SER=SA4300 //DSIVTAM DD DUMMY //******************************************************************** //DSIPRF DD DSN=&SQ2..SINGPRF,DISP=SHR, SA TARGET @L2C // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ1..DSIPRF,DISP=SHR, NETVIEW TARGET // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //* SA z/OS Message library //* //DSIMSG DD DSN=&SQ2..SINGMENU,DISP=SHR, SA US @L2C // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ1..SDSIMSG1,DISP=SHR, NETVIEW TARGET // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //* SA z/OS Panel library //* //BNJPNL1 DD DSN=&SQ1..BNJPNL1,DISP=SHR, // UNIT=3390,VOL=SER=SA4300 //BNJPNL2 DD DSN=&SQ1..BNJPNL2,DISP=SHR, // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //CNMPNL1 DD DSN=&SQ2..SINGPENU,DISP=SHR, SA US @L2C // UNIT=3390,VOL=SER=SA4300 // DD DSN=&SQ1..CNMPNL1,DISP=SHR, NETVIEW US // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //* AUTOMATION STATUS FILE //* //AOFSTAT DD DSN=&Q1..&DOMAIN..STATS,DISP=SHR, // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //* SA z/OS password dataset //* //INGPSWD DD DSN=&Q1..INGXSG&GRPID..INGPSWD, // UNIT=3390,VOL=SER=SA4300, // DISP=SHR,AMP='AMORG,BUFNI=10,BUFND=5' //******************************************************************** //* Relational Data Services File (RDS) //* //INGEMUGL DD DSN=&VQ2..&DOMAIN..EMUGLBL,DISP=SHR, // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //* IPLDATA collection dataset //* //HSAIPL DD DSN=&VQ2..INGXSG&GRPID..IPLDATA,DISP=SHR, // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //* NETVIEW LOG DATASETS //* //DSILOGP DD DSN=&VQ1..&DOMAIN..DSILOGP, // UNIT=3390,VOL=SER=SA4300, // DISP=SHR,AMP='AMORG,BUFNI=20,BUFND=20' //DSILOGS DD DSN=&VQ1..&DOMAIN..DSILOGS, // UNIT=3390,VOL=SER=SA4300, // DISP=SHR,AMP='AMORG,BUFNI=20,BUFND=20' //******************************************************************** //* NetView trace log //* - enable the following entries according to your needs //*DSITRCP DD DSN=&VQ1..&DOMAIN..DSITRCP,DISP=SHR,AMP=AMORG //*DSITRCS DD DSN=&VQ1..&DOMAIN..DSITRCS,DISP=SHR,AMP=AMORG //******************************************************************** //* SAVE/RESTORE FACILITY VSAM DATA BASE //* //DSISVRT DD DSN=&VQ1..&DOMAIN..DSISVRT, // UNIT=3390,VOL=SER=SA4300, // DISP=SHR,AMP=AMORG //******************************************************************** //* IWS Datasets //* //EQQMLOG DD DSN=&EQQMLOG.,DISP=SHR, // UNIT=3390,VOL=SER=TWS000 //EQQMLIB DD DSN=&EQQ..SEQQMSG0,DISP=SHR, // UNIT=3390,VOL=SER=TWS000 //EQQDUMP DD DUMMY //******************************************************************** //* Diagnostic Information //* //INGDUMP DD DSN=&VQ2..&DOMAIN..INGDUMP,DISP=SHR, // UNIT=3390,VOL=SER=SA4300 //******************************************************************** //* use the following dummy card to avoid a SYSOUT reference if you //* are starting NetView before starting JES //SYSPRINT DD DUMMY //*SYSPRINT DD SYSOUT=&SOUTA //

At this point we can do an IPL. After that, the tasks should start, but we still don’t have an automation policy DB.

After IPL

Since the tasks will have started with “SUB=MSTR”, we will only be able to see the jobLog for the INGNVSA task.

COM = "S INGEAMSA,JOBNAME=INGAM,SUB=MSTR" COM = "S INGENVSA,JOBNAME=INGNVSA,SUB=MSTR" COM = "S INGESSI,JOBNAME=INGNVSSI,SUB=MSTR"

In SDSF → DA

Emuframe image

If we want to verify that everything went well, we can stop the tasks and restart them without “SUB=MSTR”. This way, we will see the complete log and we can confirm that the tasks we are testing work.

P INGNVSA P INGNVSSI P INGAM

The INGAM task has other stop options when we cannot wait for an internal process to finish:

https://www.ibm.com/docs/en/z-system-automation/4.3.0?topic=operations-automation-managers-started-task 

F INGAM,STOP,IMMED F INGAM,STOP,FORCE Or: F INGAM,STOP,DEFER

Start with:

S INGEAMSA,JOBNAME=INGAM S INGENVSA,JOBNAME=INGNVSA S INGESSI,JOBNAME=INGNVSSI

I leave the startup log of my tasks as reference.

INGAM

The message HSAM1304A is because I have not created an automation policy DB.

1 J E S 2 J O B L O G -- S Y S T E M S 0 W 1 -- N O D E S 0 W 1 0 14.15.37 STC04482 ---- SATURDAY, 03 JAN 2026 ---- 14.15.37 STC04482 IEF695I START INGEAMSA WITH JOBNAME INGAM IS ASSIGNED TO USER START1 , GROUP SYS1 14.15.37 STC04482 $HASP373 INGAM STARTED 14.15.37 STC04482 IEF403I INGAM - STARTED - TIME=14.15.37 14.15.37 STC04482 IEF761I INGAM INGAM HSAPLIB HSAPSPLM/A DD IS ALREADY ALLOCATED AND WILL BE USED BY THIS TASK. 14.15.37 STC04482 IEE252I MEMBER HSAPRMSA FOUND IN SA430.SA00.PARMLIB 14.15.37 STC04482 IEE252I MEMBER CTIHSAZZ FOUND IN USER.Z31B.PARMLIB 14.15.37 STC04482 HSAM1004I ARM REGISTER FAILED FOR ELEMENT=HSAAM_S0W1$$$$1 TYPE=HSAMGR, IXCARM RET=0000000C RSN=00000160. 14.15.37 STC04482 HSAM1005I COMMUNICATION IS XCF ONLY. THE TAKEOVER FILE WILL BE USED FOR HOT START AND RECOVERY PURPOSES. 14.15.37 STC04482 HSAM1389I BUILD ID FOR HSAPIEHM 2022064 024003 16 01. 14.15.37 STC04482 HSAM1000I AUTOMATION MANAGER SUBTASKS ARE BEING STARTED. 14.15.37 STC04482 HSAL1083I AUTOMATION MANAGER HAS CREATED THE INITIAL POSIX THREAD WITH PID=16842760. 14.15.37 STC04482 HSAL1072I AUTOMATION MANAGER IS BLOCKING OMVS SHUTDOWN. 14.15.37 STC04482 HSAM1315I SUCCESSFUL ALLOCATION OF TAKEOVER FILE SA430.SA00.INGXSGSA.TAKEOVER. 14.15.37 STC04482 HSAL1107I REFRESH OF TAKEOVER FILE DSN=SA430.SA00.INGXSGSA.TAKEOVER WITH CURRENT AUTOMATION MANAGER DATA STARTED. 14.15.38 STC04482 HSAL1108I REFRESH OF TAKEOVER FILE DSN=SA430.SA00.INGXSGSA.TAKEOVER COMPLETED. 14.15.38 STC04482 INGY1004I AUTOMATION MANAGER CALL FAILED. RC=x'0008', REASON=x'10D4' 14.15.38 STC04482 HSAM1305I UNABLE TO PROCESS SA z/OS AUTOMATION CONFIGURATION DATA SET SA430.$POLICY.S0W1.PDB.SOCNTL. 14.15.38 STC04482 *03 HSAM1304A SPECIFY SA z/OS AUTOMATION CONFIGURATION DATA SET NAME. 14.15.38 STC04482 HSAM1310I RC=8 REAS=4308 OPCODE=08010001 (MAIN.2) ReadConfiguration. 14.15.38 STC04482 HSAM1311I Config map could not be opened, PROBLEM WITH: 040 040 'SA430.$POLICY.S0W1.PDB.SOCNTL(AOFACFMP)': ERROR 67: EDC5067I An 040 attempt was made to open a nonexistent file for read.

INGNVSSI

1 J E S 2 J O B L O G -- S Y S T E M S 0 W 1 -- N O D E S 0 W 1 0 14.15.54 STC04484 ---- SATURDAY, 03 JAN 2026 ---- 14.15.54 STC04484 IEF695I START INGESSI WITH JOBNAME INGNVSSI IS ASSIGNED TO USER START1 , GROUP SYS1 14.15.54 STC04484 $HASP373 INGNVSSI STARTED 14.15.54 STC04484 IEF403I INGNVSSI - STARTED - TIME=14.15.54 14.15.54 STC04484 CNM226I NetView Program to Program Interface initialization is completed 14.15.54 STC04484 CNM541I NetView subsystem INGN is fully functional

INGNVSA

1 J E S 2 J O B L O G -- S Y S T E M S 0 W 1 -- N O D E S 0 W 1 0 14.15.45 STC04483 ---- SATURDAY, 03 JAN 2026 ---- 14.15.45 STC04483 IEF695I START INGENVSA WITH JOBNAME INGNVSA IS ASSIGNED TO USER START1 , GROUP SYS1 14.15.45 STC04483 $HASP373 INGNVSA STARTED 14.15.45 STC04483 IEF403I INGNVSA - STARTED - TIME=14.15.45 14.15.45 STC04483 DSI244I NETVIEW TRACE ACTIVE FOR TASK = ALL : MODE = INT, SIZE = 4000 WITH OPTIONS = QUE PSS DISP STOR UEXIT MOD SAF TCP 14.15.45 STC04483 DSI899I DSI244I , SAF TRACE = FAILURES FOR REQUEST TYPES = AUTH EXTRACT FASTAUTH LIST STAT TOKENMAP TOKENXTR VERIFY 14.15.45 STC04483 CNM910I 'BPX1SDD WITH PROCESSDEFER+JOBPERM+NOJSTUNDUB+UNIQUEACEE' REQUEST ACCEPTED 14.15.45 STC04483 IEC141I 013-64,IFG0196J,INGNVSA,INGNVSA,DSIVTAM,,, 050 050 NULLFILE 14.15.45 STC04483 DSI530I 'DSIDCBMT' : 'DSIDCBMT' IS READY AND WAITING FOR WORK 14.15.46 STC04483 DSI530I 'DSITIMMT' : 'DSITIMMT' IS READY AND WAITING FOR WORK 14.15.46 STC04483 BNH350I NETVIEW HIGH-LEVEL LANGUAGE SUPPORT HAS BEEN SUCCESSFULLY INITIALIZED WITH LE/370 LIBRARIES 14.15.46 STC04483 DSI530I 'DSIHLLMT' : 'DSIHLLMT' IS READY AND WAITING FOR WORK 14.15.46 STC04483 DSI530I 'DSISTMMT' : 'DSISTMMT' IS READY AND WAITING FOR WORK 14.15.46 STC04483 DSI530I 'DSILOGMT' : 'DSILOGMT' IS READY AND WAITING FOR WORK 14.15.46 STC04483 ICH70001I SA01PPT LAST ACCESS AT 13:03:14 ON SATURDAY, JANUARY 3, 2026 14.15.46 STC04483 DWO854I Canzlog is active. 14.15.53 STC04483 DSI556I DSILOG : VSAM DATASET 'OPEN' COMPLETED, DDNAME = 'DSILOGP' RETURN CODE = X'00', ACB ERROR FIELD = X'00' 14.15.53 STC04483 DSI556I DSILOG : VSAM DATASET 'OPEN' COMPLETED, DDNAME = 'DSILOGS' RETURN CODE = X'00', ACB ERROR FIELD = X'00' 14.15.53 STC04483 DSI530I 'DSILOG ' : 'DST' IS READY AND WAITING FOR WORK 14.15.53 STC04483 DSI240I DSILOG : NETWORK LOG IS NOW ACTIVE 14.15.53 STC04483 BNH803I VALUE *NONE* FOR KEYWORD ARCHIVE.HLQ CONFLICTS WITH VALUE YES FOR KEYWORD ARCHIVE.WRITE 14.15.54 STC04483 DWO840I OPER1 IS NOT DEFINED TO NETVIEW 14.15.54 STC04483 DWO840I NETOP1 IS NOT DEFINED TO NETVIEW 14.15.54 STC04483 NetView "SA01" style sheet processing has begun. 14.15.54 STC04483 This is an example styleMsg statement in CNMSTUSR. 14.15.54 STC04483 There is one blank preceding the earlier "is". 14.15.54 STC04483 Remember, NetView is one word. The value of &DOMAIN 14.15.54 STC04483 is "SA01" and &NV2I is "NM". 14.15.54 STC04483 BNH111I NETVIEW LOGON SCREEN BYPASS IS NOW ENABLED. 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTINIT1 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTINIT2 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTOAON 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTOCMON 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTOCSMF 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTOEDAT 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTOPSAV 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTOXCF 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTOXDSC 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTO1 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK AUTO2 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK DBAUTO1 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK DSIIPCHK 14.15.54 STC04483 CNM570I STARTING AUTOMATION TASK MVSCMDS 14.15.54 STC04483 ICH70001I AUTINIT1 LAST ACCESS AT 13:03:29 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTINIT2 LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTOAON LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTOCMON LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTOCSMF LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTOEDAT LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTOPSAV LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTOXCF LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTOXDSC LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTO1 LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I AUTO2 LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I DBAUTO1 LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I DSIIPCHK LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.54 STC04483 ICH70001I MVSCMDS LAST ACCESS AT 13:03:23 ON SATURDAY, JANUARY 3, 2026 14.15.55 STC04483 DWO044I AUTOMATION TABLE LISTING 'LISTNAME' SUCCESSFULLY GENERATED 14.15.55 STC04483 DSI410I DSIPARM MEMBER DSITBL01 BEING USED FOR NETVIEW AUTOMATION 14.15.55 STC04483 *04 DSI802A SA01 REPLY WITH VALID NCCF SYSTEM OPERATOR COMMAND 14.15.55 STC04483 DSI530I 'DSIWTOMT' : 'SYSOP' IS READY AND WAITING FOR WORK 14.15.55 STC04483 DSI530I 'DSIACBMT' : 'SA01' IS READY AND WAITING FOR WORK 14.15.55 STC04483 DSI530I 'DSIGKPMT' : 'DSIGKPMT' IS READY AND WAITING FOR WORK 14.15.55 STC04483 DSI530I 'CNMCSSIR' : 'Subsystem Router' IS READY AND WAITING FOR WORK 14.15.55 STC04483 INGY1131I PPI Receiver INGUXPPI is active. TASK=INGUXPPI 14.15.55 STC04483 CNM112I LOG BROWSE TASK INITIALIZATION IS COMPLETE 14.15.55 STC04483 DWO154I NETVIEW HAS RECEIVED JES JOBID STC04483 14.15.55 STC04483 DSI530I 'DSIRQJOB' : 'OPT' IS READY AND WAITING FOR WORK 14.15.55 STC04483 DSI556I DSISVRT : VSAM DATASET 'OPEN' COMPLETED, DDNAME = 'DSISVRT' RETURN CODE = X'00', ACB ERROR FIELD = X'00' 14.15.55 STC04483 DSI530I 'DSISVRT ' : 'DST' IS READY AND WAITING FOR WORK 14.15.55 STC04483 DWO320I DSIUDST IS ACTIVATING WITH SECURITY LEVEL: NONE 14.15.55 STC04483 DSI530I 'DUIDGHB ' : 'DST' IS READY AND WAITING FOR WORK 14.15.55 STC04483 DSI530I 'DSIUDST ' : 'DST' IS READY AND WAITING FOR WORK 14.15.55 STC04483 DSI530I 'EZLTCFG ' : 'DST' IS READY AND WAITING FOR WORK 14.15.55 STC04483 BNH740I REMOTE OPERATIONS USING TCP/IP TCPIP ARE NOW ENABLED 14.15.55 STC04483 DUI513I STATUS FOCAL POINT READING INITIALIZATION PARAMETERS FROM 'DUIFPMEM' AS SPECIFIED IN 'DUIISFP'. 14.15.55 STC04483 DSI530I 'CNMTAMEL' : 'DST' IS READY AND WAITING FOR WORK 14.15.56 STC04483 DSI530I 'DSIHPDST' : 'DST' IS READY AND WAITING FOR WORK 14.15.58 STC04483 DSI633I CNMEAUTB COMMAND SUCCESSFULLY COMPLETED 14.15.58 STC04483 Auxiliary commands beginning. 14.15.58 STC04483 EXCMD AUTOAON,EZLEANTL 14.15.58 STC04483 DSI112I SA01 READY FOR LOGONS AND SYSTEM OPERATOR COMMANDS 14.15.58 STC04483 DWO854I VTAM is active. 14.15.58 STC04483 DSI530I 'DSIMONIT' : 'DSIMONIT' IS READY AND WAITING FOR WORK 14.15.58 STC04483 DSI530I 'DSIXCFMT' : 'DSIXCFMT' IS READY AND WAITING FOR WORK 14.15.59 STC04483 AOF617I SA z/OS INITIALIZATION STARTED 14.15.59 STC04483 DWO854I ?MVSCMDREVISION is active. 14.15.59 STC04483 BNH592I MEMBER SA01 HAS JOINED GROUP DSIPLX01. 14.15.59 STC04483 BNH588I WAITING FOR SYSPLEX MASTER IN GROUP DSIPLX01 TO BECOME ACTIVE. 14.15.59 STC04483 IEA630I OPERATOR AINIT1W1 NOW ACTIVE, SYSTEM=S0W1 , LU=AUTINIT1 14.15.59 STC04483 DISPLAY T 14.15.59 STC04483 IEE136I LOCAL: TIME=14.15.59 DATE=2026.003 UTC: TIME=13.15.59 DATE=2026.003 14.16.00 STC04483 ICH70001I AUTINIT1 LAST ACCESS AT 14:15:54 ON SATURDAY, JANUARY 3, 2026 14.16.02 STC04483 RO T=28,*ALL,D IPLINFO 14.17.16 STC04483 DSI530I 'DSI6DST ' : 'DST' IS READY AND WAITING FOR WORK 14.17.16 STC04483 BNH020I DSI6SCF PROCESSED SUCCESSFULLY. 0 ENTRY POINTS WERE ADDED TO THE SPHERE OF CONTROL

Access to NetView

To access NetView, in the case of ADCD, we will use the command:

L SA01

In other systems it could be:

logon applid(SA01) or logon applid=SA01

The application name is found in the MNING01 member that we included in the VTAMLST library earlier.

Parameter: “SA01 APPL”

Emuframe image

Emuframe image

Emuframe image

When we enter, we can define the keys to move through the NetView log (BLOG command) using the PFKDEF command.

Emuframe image

Configure PF Keys by default

If we don’t want to assign the PF Keys every time we log in, we must define the NETVIEW segment for the desired user:

ALTUSER your_userid NETVIEW(IC(LOGPROF1) MSGRECVR(NO) CTL(GLOBAL)) ALTUSER IBMUSER NETVIEW(IC(LOGPROF1) MSGRECVR(NO) CTL(GLOBAL))

Emuframe image

This way, when logging in, the REXX LOGPROF1 will be executed automatically which, among other things, assigns the PF Key definition.

Emuframe image

With the SDF command, we can enter the panels that will later show us the status of the tasks in the system. It will not yet show anything relevant because we don’t have the automation policy DB.

Emuframe image

At this point we already have a stable first startup.

The next step will be to create an automation policy DB. This information will be in another section on the website.

Last updated on