Installing Entire Operations on Mainframes

This section describes step by step how to complete the installation of Entire Operations (product code: NOP) under z/OS, BS2000 and z/VSE. The main parts of it are identical for all 3 operating systems. Where the procedure differs according to operating system this is described under separate headings: z/OS, BS2000, and z/VSE.

This section also contains information about installation on UNIX. It is therefore recommended to read this section as well if Entire Operations is to be installed on a UNIX platform.

Naming Conventions

Notation vrs or vr:

When used in this document, the notation vrs or vr represents the relevant product version.

This document covers the following topics:

• Installation Medium

• System Maintenance Aid (SMA)

• Installation and Migration Procedure

• Installing Updates

• Interfaces to other Software AG Products

• Interfaces to other Operating Systems

• Security Definitions

• Starting Entire Operations for the First Time

• Import and Export of Entire Operations Data

• Naming Conventions for Work Files

Installation Medium

The installation medium (for example, tape or CD ROM) contains the following data sets/files listed in the following table. The sequence in which the files are located on the medium is shown in the Software AG Product Delivery Report which accompanies the installation medium.

The installation medium can contain files with problem fixes. Refer to the problem descriptions before applying them.

The notation vrs in file names represents the version number of the product.

System Automation Tools (SAT) files are included as described in the System Automation Tools documentation.

Copying Data Sets to a z/OS Disk

Copy the data sets from the supplied installation medium to your disk before you perform the individual installation procedure for each component to be installed.

The way you copy the data sets depends on the installation method and the medium used:

• If you use System Maintenance Aid (SMA), refer to the copy job instructions provided in the System Maintenance Aid documentation.

• If you are not using SMA and want to copy the data sets from CD-ROM, refer to the README.TXT file on the CD-ROM.

• If you are not using SMA and want to copy the data sets from tape, follow the instructions in this section.

This section explains how to copy all data sets from tape to disk.

• Step 1: Copy Data Set COPY.JOB from Tape to Disk
• Step 2: Modify hilev.COPY.JOB on Your Disk
• Step 3: Submit COPY.JOB

Step 1: Copy Data Set COPY.JOB from Tape to Disk

• Modify the following sample job according to your requirements:

  //SAGTAPE JOB SAG,CLASS=1,MSGCLASS=X
  //* ---------------------------------
  //COPY EXEC PGM=IEBGENER
  //SYSUT1 DD DSN=COPY.JOB,
  // DISP=(OLD,PASS),
  // UNIT=(CASS,,DEFER),
  // VOL=(,RETAIN,SER=tape-volser),
  // LABEL=(2,SL)
  //SYSUT2 DD DSN=hilev.COPY.JOB,
  // DISP=(NEW,CATLG,DELETE),
  // UNIT=3390,VOL=SER=disk-volser,
  // SPACE=(TRK,(1,1),RLSE),
  // DCB=*.SYSUT1
  //SYSPRINT DD SYSOUT=*
  //SYSIN DD DUMMY
  //

  where:

  tape-volser is the VOLSER of the tape, for example: T12345,
  hilev is a valid high-level qualifier, and
  disk-volser is the VOLSER of the disk.

• Execute the job to copy the data set COPY.JOB to your disk.

Step 2: Modify hilev.COPY.JOB on Your Disk

• Modify hilev.COPY.JOB according to your requirements:

  Set EXPDT to a valid expiration date, for example, 99365.

  Set HILEV to a valid high-level qualifier, for example, USERLIB.

  Set LOCATION to a storage location, for example, STORCLAS=ABC or UNIT=3390,VOL=SER=USR123.

Step 3: Submit COPY.JOB

• Execute hilev.COPY.JOB to copy single, multiple, or all data sets to your disk.

Copying Files to a BS2000 Disk

Copy the files (data sets) from the supplied installation medium to your disk before you perform the individual installation procedure for each component to be installed.

The way you copy the files depends on the installation method and the medium used:

• If you use System Maintenance Aid (SMA), refer to the copy job instructions provided in the System Maintenance Aid documentation.

• If you are not using SMA and want to copy the files from CD-ROM, refer to the README.TXT file on the CD-ROM.

• If you are not using SMA and want to copy the files from tape, follow the instructions in this section.

This section explains how to copy all files from tape to disk.

• Step 1: Copy Library SRVvrs.LIB from Tape to Disk
• Step 2: Copy the Procedure COPY.PROC from Tape to Disk
• Step 3: Copy all Product Files from Tape to Disk

Step 1: Copy Library SRVvrs.LIB from Tape to Disk

This step is not necessary if you have already copied the library SRVvrs.LIB from another Software AG installation tape. For further information, refer to the element #READ-ME in this library. The library SRVvrs.LIB is stored on the tape as a sequential file named SRVvrs.LIBS containing LMS commands. The current version vrs can be obtained from the Software AG Product Delivery Report.

• Execute the following commands to convert SRVvrs.LIBS into an LMS library:

  /IMPORT-FILE  SUPPORT=*TAPE(FILE-NAME=SRVvrs.LIBS,-
  /   VOLUME=volser, DEV-TYPE=tape-device)
  /ADD-FILE-LINK  LINK-NAME=EDTSAM, FILE-NAME=SRVvrs.LIBS,-
  /   SUPPORT=*TAPE(FILE-SEQ=3), ACC-METH=*BY-CAT,-
  /   BUF-LEN=*BY-CAT, REC-FORM=*BY-CAT, REC-SIZE=*BY-CAT
  /START-EDT 
  @READ  '/'
  @SYSTEM 'REMOVE-FILE-LINK  EDTSAM'
  @SYSTEM 'EXPORT-FILE  FILE-NAME=SRVvrs.LIBS'
  @WRITE  'SRVvrs.LIBS'
  @HALT
  /ASS-SYSDTA  SRVvrs.LIBS
  /MOD-JOB-SW  ON=1
  /START-PROG  $LMS
  /MOD-JOB-SW  OFF=1
  /ASS-SYSDTA  *PRIMARY

  where:

  tape-device is the device type of the tape, for example, TAPE-C4, and
  volser is the VOLSER of the tape (see the Software AG Product Delivery Report).

Step 2: Copy the Procedure COPY.PROC from Tape to Disk

• Call the procedure P.COPYTAPE in the library SRVvrs.LIB to copy the procedure COPY.PROC to disk:

  /CALL-PROCEDURE  (SRVvrs.LIB,P.COPYTAPE), -
  /   (VSNT=volser, DEVT=tape-device)

  If you use a TAPE-C4 device, you can omit the parameter DEVT.

Step 3: Copy all Product Files from Tape to Disk

• Enter the procedure COPY.PROC to copy all product files to disk:

  /ENTER-PROCEDURE  COPY.PROC, DEVT=tape-device

  If you use a TAPE-C4 device, you can omit the parameter DEVT.

  The result of this procedure is written to the file L.REPORT.SRV.

Copying Files Contents to a z/VSE Disk

Copy the data sets from the supplied installation medium to your disk before you perform the individual installation procedure for each component to be installed.

The way you copy the data sets depends on the installation method and the medium used:

• If you use System Maintenance Aid (SMA), refer to the copy job instructions provided in the System Maintenance Aid documentation.

• If you are not using SMA and want to copy the data sets from CD-ROM, refer to the README.TXT file on the CD-ROM.

• If you are not using SMA and want to copy the data sets from tape, follow the instructions in this section.

This section explains how to copy the data sets .LIBJ, .LIBR and .LICS from tape to disk. All other data sets can be installed directly from the tape.

• Step 1: Copy Data Set COPYTAPE.JOB to Disk
• Step 2: Modify COPYTAPE.JOB on Your Disk
• Step 3: Submit COPYTAPE.JOB

Step 1: Copy Data Set COPYTAPE.JOB to Disk

• Modify the following sample job according to your requirements:

  * $$ JOB JNM=LIBRCAT,CLASS=0,                                          +
  * $$ DISP=D,LDEST=(*,UID),SYSID=1                                      
  * $$ LST CLASS=A,DISP=D                                                
  // JOB LIBRCAT                                                         
  * *****************************************                            
  *     STORE COPYTAPE.JOB IN LIBRARY                                    
  * *****************************************
  // ASSGN SYS004,nnn 
  // MTC REW,SYS004                                                        
  // MTC FSF,SYS004,4                                                      
  ASSGN SYSIPT,SYS004                                                      
  // TLBL IJSYSIN,'COPYTAPE.JOB'                                           
  // EXEC LIBR,PARM='MSHP; ACC S=lib.sublib'
  /*
  // MTC REW,SYS004
  ASSGN SYSIPT,FEC                                                         
  /*                                                                       
  /&                                                                     
  * $$ EOJ

  where:

  nnn is the tape address, and
  lib.sublib is the library and sublibrary in which the data set COPYTAPE.JOB is to be stored.

• Execute the job to copy the data set COPYTAPE.JOB to disk.

  COPYTAPE.JOB contains the JCL required to copy the data sets .LIBJ, .LIBR and .LICS from tape to disk.

Step 2: Modify COPYTAPE.JOB on Your Disk

• Modify COPYTAPE.JOB according to your requirements and set the disk space parameters as appropriate.

Step 3: Submit COPYTAPE.JOB

• Execute COPYTAPE.JOB to copy the data sets .LIBJ, .LIBR and .LICS to your disk.

Installing an Update Medium

The following applies to the Entire System Management products Entire Operations, Entire Output Management and Entire Event Management.

Before you update any production library or file using a single solution or an update medium containing a series of solutions supplied by Software AG, you must stop the Monitor of the relevant Entire System Management product. Do not start the Monitor before your entire update process is completed successfully. Use the Natural utility SYSBPM to purge all modules of the application SYSEOR from the Natural buffer pool.

This is necessary to avoid mixing the versions of the delivered software, for example in Natural libraries where such a mixture may lead to parameter errors like NAT0935, NAT0936 etc.

System Maintenance Aid (SMA)

For each step of the installation procedure, System Maintenance Aid (SMA) generates an installation job according to your specifications in SMA. You then submit and run the generated job.

Before you can start generating the jobs, you have to load the data set SMT111.TABS from the installation medium into the SMA system file. SMT111.TABS contains the tables SMA requires to build the jobs.

SMA is supplied with base Natural. For instructions on loading the data set and using SMA, refer to the System Maintenance Aid Documentation.

Readme File

To view a product-specific Readme

• From the product list on an SMA Maintenance screen, execute the RM (Show Readme File) command for the required product(s).

Installation and Migration Procedure

• Step 1: Load System Files

• Step 2: Delete the old Entire Operations Objects

• Step 3: Load New Entire Operation Objects and Error Messages

• Step 4: Copy Programs or Module in a Non-Security Environment

• Step 5: Migration from Entire Operations Version 5.2.1 or 5.3.1 to Version 5.4.3

• Step 6: Import Entire Operations Network Examples (optional)

• Step 7: Data Migration in Batch Mode

• Step 8: Adapt System Automation Tools Parameters for Entire Operations

Step 1: Load System Files

(Job I050, Steps 2100, 2102, 2104)

If you want to install the product Entire Operations for the first time, load the System files by using the Adabas ADALOD utility.

1. Step 2100:

   Load the Entire Operations System File 1 contained in the data set NOPvrs.SYS1 by using the Adabas ADALOD utility.

2. Step 2102 - Optional Entire Operations Log Selection:

   Load the Entire Operations System File 3, contained in the data set NOPvrs.SYS3 by using the Adabas ADALOD utility.

   Entire Operations System File 1 holds all definitions and information needed to control the batch job processing. The file supplied on the installation tape contains some examples. If you do not want these examples, load the file with the ADALOD parameter NUMREC=0.

3. Step 2104 - ADALOD for Accounting System File 4:

   Load the Entire Operations System File 4, contained in the data set NOPvrs.SYS4 by using the Adabas ADALOD utility.

Step 2: Delete the old Entire Operations Objects

(Job I051, Steps 2100, 2101)

1. Step 2100:

   Delete old objects starting with NOP* in the SYSTEM library on FNAT and FUSER.

2. Step 2101:

   Delete all objects of the previously installed version from the SYSEOR library.

Step 3: Load New Entire Operation Objects and Error Messages

(Job I061, Step 2100)

• Load the Entire Operations objects from the NOPvrs.INPL data set by using the Natural INPL utility.

  Use the Natural system command INPL (which is described in the Natural System Commands documentation) to load the Entire Operations system objects.

  The following libraries are loaded:

  Library	File	Contents
  SYSEOR	FNAT	Entire Operations Programs
  SYSEORH1	FNAT	Entire Operations Help Data (English)
  SYSEORH2	FNAT	Entire Operations Help Data (German)
  SYSTEM	FUSER	Entire Operations Programs starting with NOP...
  SYSEORU	FNAT	Entire Operations Example User Exit

Step 4: Copy Programs or Module in a Non-Security Environment

(Job I082, Step 2111)

• Copy program MENU from library SYSSAT to library SYSEOR (in non-security environments only).

Step 5: Migration from Entire Operations Version 5.2.1 or 5.3.1 to Version 5.4.3

• Migration from Entire Operations Version 5.2.1 to Version 5.3.1
• Migration from Entire Operations Version 5.3.1 to Version 5.4.3
• Migration of System File 3
• Migration of System Automation Tools Log File

Migration from Entire Operations Version 5.2.1 to Version 5.3.1

(Job I082, Steps 2113, 2115, 2117, 2119, 2121)

Add or change fields in the Entire Operations System File 1.

1. Step 2113: Add Entire Operations Version 5.3.1 fields.

2. Step 2115: Change Entire Operations Version 5.3.1 fields.

3. Step 2117: Add new Version 5.3.1 descriptor.

4. Step 2119: Release superdescriptor.

5. Step 2121: Add Version 5.3.1 superdescriptor

Migration from Entire Operations Version 5.3.1 to Version 5.4.3

(Job I082, Steps 2123, 2125, 2127, 2129, 2131, 2133)

Add or change fields in the Entire Operations System File 1.

1. Step 2123: Delete Entire Operations Version 5.3.1 fields.

2. Step 2125: Create Entire Operations Version 5.4.3 fields.

3. Step 2127: Change Entire Operations Version 5.4.3 fields.

4. Step 2129: Add Version 5.4.3 descriptor.

5. Step 2131: Release superdescriptor.

6. Step 2133: Add Version 5.4.3 superdescriptor.

Migration of System File 3

The format of the Entire Operations System File 3 has not changed from Entire Operations Version 5.3.1 to Entire Operations Version 5.4.3.

A Version 5.3.1 System File 3 can be used under Entire Operations Version 5.4.3.

Migration of System Automation Tools Log File

The format of the System Automation Tools log file has changed with System Automation Tools Version 3.4. You can still use a log file from Entire Operations Version 5.3.1 under Entire Operations Version 5.4.3, but we recommend that you use the new log file.

Step 6: Import Entire Operations Network Examples (optional)

(Job I200, Step 2105)

If you want to install the product Entire Operations for the first time, import the examples networks.

• Import the Entire Operations examples contained in the data set NOPvrs.DATA.

Step 7: Data Migration in Batch Mode

(Job I200, Step 2110)

• Migrate the accounting data on the Entire Operations System File 4.

  The data migration can be performed only if the Entire Operations Monitor is not active.

Step 8: Adapt System Automation Tools Parameters for Entire Operations

• Mandatory Parameter Blocks/Parameters
• Specific Parameters
• RPC Server for the Entire Operations GUI Client
• Example

Mandatory Parameter Blocks/Parameters

¹ Under BS2000 these subtasks are simulated by Entire System Server.

² Pointer to Entire Operations System File 1

³ Pointer to System Automation Tools log file.

⁴ These pointers can be alternately set in the common Natural parameter module created for the System Automation Tools products or in a Natural parameter profile indicated by the Natural parameter PROFILE.

Specific Parameters

Furthermore, you can overwrite the SATENV and NATENV parameters with Entire Operations-specific assignments. The naming convention for the prefix which identifies the parameter block is:

Prefix = NOPprefix-from-satstart-block

¹ You can specify a member where Entire Operations-specific parameters are located.

RPC Server for the Entire Operations GUI Client

This chapter is relevant only if you want to use Entire Operations GUI Client (OGC) with your installation.

Example of an RPC server SYSPARM profile definition:

FNAT=(9,140),FUSER=(9,124),FSEC=(9,125),FDIC=(9,141)
AUTO=OFF,TQ=OFF,ETID=' ',INTENS=1
DU=ON
LFILE=(216,9,7)
LFILE=(131,9,15)
LFILE=(85,9,95)
LFILE=(206,9,242)
LFILE=(204,9,140)
RPC=(SERVER=ON,ACIVERS=4,SIZE=32,SRVNODE=broker-name,SRVNAME=service-name,
TIMEOUT=59,TRACE=1,MAXBUFF=28,NTASKS=2,SRVUSER='*NSC')

Example

System Automation Tools (SAT) Environment Settings

SAT	SATENV	NATTASK=NSATT08 NATBATCH=NATvrsBA NATSKEL=EORJSMVS NSC=YES NSCUSER=EORMON NSCPSWD=EORMON1
SAT	SATENV	NATTASK=NSATT08 NATBATCH=NATvrsBA NATSKEL=EORJSMVS NSC=YES NSCUSER=EORMON NSCPSWD=EORMON1
NOPvrs	SATENV	NATTASK=NSATT08 NATBATCH=NATvrsBA NATSKEL=EORJSMVS NSC=YES NSCUSER=EORMON NSCPSWD=EORMON1	/* Entire Operations Monitor, subtask
NOPBAT	SATENV	NATTASK=NSATT08 NATBATCH=NATvrsBA NATSKEL=EORJSMVS JOBPREF=SN NSC=NO	/* Entire Operations Monitor, batch /* JOB NAME PREFIX
NOPRPC	SATENV	NATTASK=NATSATvr NUMTASK=2 SRVNAME=NOPvrSRV SRVNODE=BKRvrs PROFILE=WATCHDOG	/* Entire Operations RPC server

Natural Environment Settings

SAT	NATENV	DU=OFF
SAT	NATENV	DU=OFF
NOPvrs	NATENV	FUSER=(9,90)
		FNAT=(9,80)
		FSEC=(9,83)
		MAXCL=0
		MADIO=0
		MT=0
		AUTO=OFF
		IM=D,ID=','
		WH=ON
		LFILE=(216,9,89)	/* Entire Operations System File 1
		LFILE=(131,9,23)	/* System Automation Tools log file
		LFILE=(85,9,95)	/* Entire Operations System File 4
		LFILE=(251,21,16)	/* Con-nect SYSF file
		LFILE=(206,9,111)	/* Entire Output Management SYSF file
		LFILE=(204,9,80)	/* SYSSATU FNAT file
NOPBAT	NATENV	PARM=E41200BP
		IM=D
		AUTO=OFF
		FUSER=(9,90)
		LFILE=(204,9,80)	/* SYSSATU FNAT file
NOPRPC	NATENV	FNAT=(9,140) PROFILE=NOPvrsRP	Refer to RPC Server for the Entire Operations GUI Client above.

Product Automatic Start

SAT	SATSTART	PRODUCT=NOP PREFIX=vrs TYPE=SUBTASK APPLLIB=SYSEOR SERVSYSF=(9,89)	/* Entire Operations Monitor, subtask

For explanations of the System Automation Tools parameters, see the appropriate descriptions in the System Automation Tools documentation.

Notes:

1. NOPvrs, NOPBAT and NOPRPC are the proposed names for Entire Operations subtask, Entire Operations batch and Entire Operations RPC server. They can be modified.
2. If Natural Security is installed, specify AUTO=OFF in NATENV; if not installed, specify AUTO=ON.

Installing Updates

If an update for Entire Operations is to be installed, do the following:

1. Ensure that the Entire Operations Monitor is not active and that online users have logged off. Otherwise, data can be lost or corrupted.

2. Copy the update completely to the affected target libraries. Verify this.

3. When the new modules are in place, purge the Natural buffer pool for online and/or monitor usage.

4. In the Entire Operations main menu, enter the direct command TECH. The version information is displayed and updated for monitor usage.

The monitor error transaction is able to detect a version mix if a runtime error occurs. In this case, all monitor tasks will immediately be terminated with an error message.

Interfaces to other Software AG Products

• Con-nect Interface

• Interface to Entire Output Management

Con-nect Interface

If you intend to transfer messages from Entire Operations to Con-nect, the application programming interface must be copied; you must copy all objects starting with Z from the library SYSCNT2 to the library SYSEOR.

In addition, you have to add a standalone cabinet to Con-nect with:

This cabinet serves as a sender-cabinet for the indicated messages and has no other functions. Ensure that the cabinet SYSEOR is never locked because this forces an abnormal Monitor termination.

Interface to Entire Output Management

If you want to use the Entire Output Management (NOM) Application Programming Interface to pass SYSOUT and files to Entire Output Management, you must:

• Define the LFILE 206 for the Entire Output Management System File in the System Automation Tools startup parameters, and/or define the NTLFILE 206 in the Natural parameter module for Entire Operations.

• Add the library SYSNOM (Entire Output Management Application Programming Interface) to the STEPLIB definitions of Entire Operations in Natural Security.

Interfaces to other Operating Systems

• z/OS Interfaces

• BS2000 Interfaces

• UNIX and Windows Interfaces

• SAP R/3 Interfaces

z/OS Interfaces

• CA-LIBRARIAN Interface
  To activate the CA-LIBRARIAN interface, you must assemble and link the Entire System Server module NATPAML into the Entire System Server Load Library. For instructions, please refer to the Entire System Server Reference Documentation.

• Force Job Display to Console
  To recognize whether a job has terminated normally, Entire Operations needs the terminate message (IEF404I ...) for each job. If not yet installed, modify each member CONSOLxx in the SYS1.PARMLIB library, which defines the z/OS master console and alternate consoles.

  Insert the entry MONITOR(JOBNAMES-T) for automatic job display. Make sure there is no entry in any MPFLSTxx member in SYS1.PARMLIB to suppress message IEF404I.

BS2000 Interfaces

• LMS Interface
  For access to LMS elements from Entire Operations, LMS Version V1.4A or higher is required.

• UCON Interface
  For the following functions the UCON interface of Entire System Server is required:

  • Sending messages via an Entire System Server node

  • Cancel jobs

  • Hold jobs

  • Release jobs

  The UCON interface is accessed by the Entire System Server view CONSOLE. This means that the Entire System Server jobs for the console must have been started.

  If you use Entire System Server in multi-user mode (node number other than 148) these tasks will be started by Entire System Server nucleus. In single user mode, the UCON interface is only available from the user ID where the active and passive console tasks of Entire System Server are running.

UNIX and Windows Interfaces

For more information related to UNIX and Windows system access, see the section Entire Operations in Client/Server Environments.

SAP R/3 Interfaces

For more information related to SAP R/3 access, see the User's Guide.

Security Definitions

• With Natural Security

• Without Natural Security

• External Security System

With Natural Security

If Natural Security is installed at your site, you must create the following definitions:

• Applications
• Users

Applications

Notes:

• For all applications:
  Do not define a startup program. Do not define Clear Source area by Logon within Security Options. These security parameters must also be installed for any additional user applications.

• For SYSEOR - define in this order:

  1. STEPLIB=SYSSAT

  2. STEPLIB=SYSNOM (only if Entire Output Management is available)

  3. STEPLIB=SYSLIBS

  4. STEPLIB=SYSEXT

  5. STEPLIB=SYSTEM

  Do not define the error transaction: NOPERROR. (This had to be done explicitly in former versions of Entire Operations).

• For user libraries and SYSEORU (JCL, macros, user exits) - define in this order:

  1. STEPLIB=SYSEOR

  2. STEPLIB=SYSSAT

  3. STEPLIB=SYSLIBS

  4. STEPLIB=SYSEXT

  5. STEPLIB=SYSTEM

Users

(defined as a person in Natural Security)

Without Natural Security

If Natural Security is not installed at your site, proceed as follows:

Edit the System Automation Tools member as described in the sections Parameter Blocks and Parameters of the System Automation Tools documentation. Add the following lines to the parameter block of Entire Operations (SATENV):

1. STEPLIB1=(SYSEOR, dbid, fnr)

2. STEPLIB2=(SYSSAT, dbid, fnr)

3. STEPLIB3=(SYSNOM, dbid, fnr)

4. STEPLIB4=(SYSLIBS, dbid, fnr)

5. STEPLIB5=(SYSEXT, dbid, fnr)

6. STEPLIB6=(SYSTEM, dbid, fnr)

Copy the module SATSLS-P from SYSSAT to SYSEOR (if not already existing in SYSEOR).

External Security System

If Entire System Server is installed with an external security system (RACF, ACF2, TOP SECRET), a user ID for the Entire Operations Monitor must be defined in the security system. The user ID is EORnnn01, where nnn is the Monitor node number. For example, if the Monitor node is 148, define the user ID as EOR14801.

BS2000

Define the BS2000 user ID under which the Entire Operations Monitor runs (usually TSOS).

Starting Entire Operations for the First Time

If you are logged on to the SYSEOR library, you must enter the direct command INSTALL.

After the first start, the Entire Operations Installation screen is automatically invoked:

  20.11.10               ***** Entire Operations *****                    10:29:29
                                   Installation

  ------------------------------------------------------------------------------
  This program will help to make some initial definitions for and within
  Entire Operations.
  The most definitions can be modified later, by using the
  'System Administration' online functions.

  If you do not want to continue, please press the PF3 key.
  If you want to continue, please enter the following:


       User ID of the Entire Operations System Administrator ===> SYSDBA__


  Enter  ==> Continue Installation
  PF3    ==> End



 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
                   End

To proceed with installation

1. Enter "SYSDBA" in the User ID field of this screen and press ENTER.

   During the installation procedure, you can add your own user ID.

This enables you to customize Entire Operations by following the steps described in the section System Administrator Services. This includes:

• Entire Operations Defaults: BS2000 only:
  If necessary, modify the activation and submission escape characters, since $ and § cannot be used in BS2000.

  • Definition of Nodes - the user can delete unnecessary node definitions and add the appropriate ones;

  • User Maintenance.

  Notes:

  1. You cannot start the Entire Operations Monitor until the installation is finished.
  2. You will be forced to leave the Natural session after termination of the Install program, because some of the definitions are necessary for a regular user session. To work with Entire Operations after INSTALL, you must start a new Natural session.

• Single-User Mode under BS2000

• Installation Verification

• Possible Installation Verification and Startup Errors

• Migration Considerations

Single-User Mode under BS2000

If you run your Natural under TIAM, it is possible to access Entire System Server as well as the Editor in single-user mode. To do this, the following FILE statements must be given before starting Natural:

For Entire System Server:

/FILE npr-lib,LINK=DDLIB2

where npr-lib is the Entire System Server load library.

For Editor single-user mode:

/FILE workfile,LINK=CMEDIT

where workfile must be the user-specific work file, and workfile may not be accessed by any other task (refer to Installing Software AG Editor in the Natural Installation documentation.)

Installation Verification

If you have installed Entire Operations properly, issue the TECH command to display technical information for your installation. For details, see the section Online Technical Information in the section Logging on to Entire Operations of the User's Guide.

After having started the Entire Operations Monitor, you can now start some sample networks that are included in System File 1 on the installation tape. You can find these sample networks under the owner EXAMPLE. See also the sample network shown in the Import/Export Utility documentation.

Notes:

1. For detailed information on starting the Entire Operations Monitor, see the section Starting a Server in the System Automation Tools documentation and the section Entire Operations Monitor in the Administration documentation.
2. You cannot start these sample networks if you have loaded your Entire Operations System File with NUMREC=0.

To adapt the sample job networks

1. Adapt the job networks of the owner EXAMPLE, which you want to use for the installation verification.

   We recommended that you use the following networks:

   Operating System	Network	Description
   BS2000	B60-FLOW	BS2000 Job Flow
   z/OS	E60-FLOW	z/OS Job Flow
   z/VSE	V60-FLOW	z/VSE Job Flow
   UNIX	X60-FLOW	UNIX Job Flow

2. Check whether the node table contains all operating system server nodes you need (see Definition of Nodes in the section System Administrator Services).

3. For each node you want to use: enter the direct command LOGON NODE node-number and perform a logon with a valid user ID and password. This must be done to check the availability of the node, and to obtain the operating system information from the node.

4. Go to the Network Modification screen and set the fields Execution Node and JCL Node to a valid node number. If you are using network B60-FLOW or X60-FLOW, you must also check the special defaults using PF6 from this screen; then set the field Submit User ID (and for B60-FLOW also SYSOUT User ID) to a user ID valid in your environment. See also Operating System and Environment Defaults in the User's Guide.

5. The node numbers above must be propagated to all jobs of the network. Press PF9 to display the screen Application of Network Defaults to Jobs. Enter S before Exec Node and JCL Node and press ENTER to modify the jobs. For network B60-FLOW or X60-FLOW, you must also enter S before the User ID field(s) you modified in the previous step.

6. For most of the sample job networks, you will find the name of a symbol table on the Network Modification screen. Press PF7 to display the symbols within that table. Check the symbols listed in the table and, if necessary, adapt them for your needs. Use the line command M for modifications.

7. Go to the Calendar Maintenance screen. Make sure that the calendar EXAMPLECAL is defined for the current year.

8. If you use Natural Security: Make sure that the library SYSEORU is defined as Public Library. If it is defined as People Protected, you need a link to your user ID and to the user ID of the Entire Operations Monitor.

To activate a sample job network

1. Open the Entire Operations Main Menu shown in the following example:

   19.03.15 ***** Entire Operations ***** 17:50:31 Owner EXAMPLE Main Menu User ID SAG ------------------------------------------------------------------------------ Main Menu DC Solutions 1 Network and Job Maintenance 20 NATURAL ISPF 2 Active Job Networks 3 Schedule Maintenance 4 Calendar Maintenance 5 Log Information 6 Symbol Tables 7 System Administrator Services 8 Reports 9 Cross References 10 Import/Export 11 Help Command => ____________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help End Owner Mail

2. If you are not under the owner EXAMPLE, enter in the command line:

   SET OWNER EXAMPLE

   Press ENTER. (If this does not work, check your user definition for the linked owners.)

3. On the Entire Operations Main Menu, enter 1 (Network and Job Maintenance) in the Command line and press ENTER.

   A Network Maintenance screen similar to the example below appears:

   19.03.15 ***** Entire Operations ***** 18:04:21 Owner EXAMPLE Network Maintenance Selection OR________ ------------------------------------------------------------------------------- Cmd #Run Owner Network Node Description *--------- *--------- _ P 16 EXAMPLE B60-FLOW N0194 Job Flow, BS2000 _ P 14 EXAMPLE E60-FLOW N0146 Job Flow, MVS _ P EXAMPLE V60-FLOW 33 VSE Job Flow _ P EXAMPLE X60-FLOW N0501 UNIX Job Flow *********************************** m o r e ********************************** A Active C Copy D Delete F Flow G Grant H Check L List Jobs M Modify N Deact P Descr R Activate S Schedule T Acct U Vers.Usage W Disp.Sched. X History Command => ____________________________________________________________ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add End Save Up Down NxtSt Menu

   The networks are divided into different application groups. Each network consists of various jobs and demonstrates one feature of Entire Operations. These are:

   • Completion codes

   • Input conditions

   • Output conditions

   • Events

   • JCL generation

   • Recovery

   • User exits

   • Mailboxes

   • Resources

   • Job flow

   • Con-nect interface

   The following sample networks are provided:

   • E60-FLOW (for z/OS)

   • B60-FLOW(for BS2000)

   • V60-FLOW (for z/VSE)

   • X60-FLOW (for UNIX)

   Sample networks for z/OS start with the letter E, for BS2000 with B, for z/VSE with V and for UNIX with X.

   The sample networks demonstrate a sequence of interdependent jobs and are used to ensure that all of your installation has been successfully completed.

4. Enter R in the input field of the Cmd column next to the network you want to activate to open the Network Activation screen:

   19.03.15 ***** Entire Operations ***** 18:31:34 Owner EXAMP +-----------------------------------------------------+ Selection O | | ------------ | Network Activation | ---------- Cmd #Run Ow | | *- | Owner ==> EXAMPLE | _ P EX | Network ==> E60-FLOW | _ P EX | Version ==> v2.1______ | _ P EX | 17.12.13 - >>>>>>>> - current at 19.03.15 | _ P 8 EX | | _ P EX | Last Schedule Extract ==> 19.03.15 | _ P EX | at ==> 00:00:37 | _ EX | Last Execution Date ==> 19.03.15 | ymbols R P 14 EX | Last Run Number ==> 4430 | _ P EX | | _ P EX | Use Time in Schedule ==> N (Y/N) | _ P EX | or activate at Date ==> 19.03.15__ | *********** | Time ==> 18:31:42 | ********** A Active C | JCL Check only ==> N (Y/N) | y N Deact P Descr R | Enter----PF1---PF3--------------------------- | istory Command => | Activate Help End | ___ +-----------------------------------------------------+ Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12--- Help Add End Save Up Down NxtAc Menu

   Press ENTER.

To check the Entire Operations log

• Enter LOG in the Command => line and press ENTER. The sample jobs of your network should have been started and have ended OK. If this is not the case, check that you have performed the installation correctly.

  Notes:

  1. The following message in LOG can be ignored if you are using sample networks that were issued with Entire Operations 1.4x: Inv.Out Cond.Ref: E60-JOB-1 RUN-1. If you are using native Entire Operations 3.1.1 sample networks, this message is unlikely to occur.
  2. In a z/VSE environment, before activating network V60-FLOW, you are recommended to verify the definitions of End-of-Job actions for JOB-01 of this network. For this job, some message recipients are defined which may not exist in your environment. You can either overwrite these recipients with valid destination IDs, or else delete all recipient definitions. For details, see the section Message Sending in the User's Guide.

Possible Installation Verification and Startup Errors

If your installation verification fails and you cannot start Entire Operations properly, consider the following:

• You may have forgotten to use some Natural Security definitions.

• You may use improper versions of Adabas, Natural or Entire System Server.

• There are errors in your Natural definition (linkage, parameter module, etc.).

• You may have forgotten some System Automation Tools parameters or have defined them incorrectly.

• You may not have performed the installation procedure correctly.

NAT0838: Monitor Subtask Does Not Run

If your Entire Operations Monitor subtask does not start an you receive a NAT0838 error message in the System Automation Tools output, proceed as follows:

1. Log on online to SYSEOR and change the password there.

2. Modify the NSCPSWD= settings in NOPxxx SATENV in the System Automation Tools parameters as well.

3. Retry the System Automation Tools start.

Migration Considerations

Sample Networks of Previous Entire Operations Versions

In general, the installation verification can also be carried out using the sample networks delivered with previous versions of Entire Operations. However, these network definitions contained some minor inconsistencies which have been corrected in the current version. The current version also contains some additional sample network definitions, in particular those demonstrating access to UNIX nodes. It is therefore recommended that you update the sample networks by importing them from the DATA file supplied with the current Entire Operations version. For further information, see the section Import and Export of Entire Operations Data.

Import and Export of Entire Operations Data

Entire Operations provides an Import/Export utility. It can be used to transfer Entire Operations data (networks, jobs and all other objects) from one system file to another by exporting and importing the data via a work file.

For detailed information, see the Import/Export Utility documentation.

This section covers the following topics:

• Updating Sample Networks

• Importing Updated Sample Networks (optional)

• Using Sample Networks

Updating Sample Networks

The Import/Export utility can also be used to update sample network definitions (see the Import/Export Utility documentation) supplied with previous Entire Operations versions by importing the definitions from the system files supplied with the previous versions.

Step 3 in the section Importing Updated Sample Networks (optional) describes what must be done for this purpose.

Importing Updated Sample Networks (optional)

This step is recommended when migrating from any previous version of Entire Operations. It can also be useful for backing out modifications made to sample network definitions, or for loading the sample networks into your system file, if your Entire Operations System Files were initially loaded with NUMREC=0.

To import updated sample networks

1. Assign the Natural Workfile 1 to the NOPvrs.DATA file and invoke the Import Utility to load the sample networks. This can be done online in a TIAM (BS2000) or TSO (z/OS) Natural environment, or preferably in batch mode as described in the sections Using the Import/Export Utility in Batch Mode and Import in the Import/Export Utility documentation.

2. If you intend to update the sample network B60-FLOW (see the Import/Export Utility documentation), you are recommended to delete this network manually from the Entire Operations Network Maintenance screen prior to the steps following below. You can omit this deletion step if you do not use BS2000 functionality, or if you have defined your own jobs within network B60-FLOW.

3. Use the Initial Mode A to load some new sample networks, especially demonstrating access to UNIX nodes, and/or use the Initial Mode U to update existing examples belonging to the owner EXAMPLE. In either case, you are advised to set the parameters ERROR LIMIT and WARNING LIMIT to 9999. See Job I200, Step 2105. This is only necessary if this is a first-time installation and not an update.

Using Sample Networks

To use the sample networks

1. In the network definition (see Fields and Commands: Network Definition in the User's Guide), adapt the JCL node and execution node to a node you want to use.

2. In the operating system specific entries, check the JCL User ID and Submit User ID fields: see Input Fields: Network Defaults in the section Operating System and Environment Defaults in the User's Guide.

3. With the function Application of Network Defaults to Jobs (see the User's Guide), copy the modified definitions into the jobs.

4. For MAC-type jobs (Macro), you must edit the JCL and enter the command MACRO to get an executable Macro program. This must be done prior to the first execution of the network or job.

Naming Conventions for Work Files

Entire Operations creates its own work files if jobs are executed on one of the following operating systems:

• BS2000

• UNIX

• Windows

Work files are deleted automatically by the Entire Operations monitor during the cleanup of active job networks.

• BS2000

• UNIX

• Windows

• File Name Generation Exit

BS2000

BS2000 work files are created with the following names:

:catid:$sysout-userid.owner.network.run.job#suffix

Work File Extensions

Extension	Explanation
None	Current SYSOUT file.
1 through 9	Previous SYSOUT files.
E	Temporary Enter file. Will be deleted after job submission.
M	Monitor job variable.
A through Z, apart from E, M	SYSOUT file copies which are to be passed to Entire Output Management.

Note:
The maximum file length in BS2000 is 54.

Special Work File Names

BS2000 temporary print files are created with the following names:

:catid:$bs2000-userid.EOR.PRINT.node.date.time

Variable	Explanation
catid	BS2000 catalog ID for the file.
bs2000-userid	BS2000 user ID (submit user ID or SYSOUT user ID).
node	Entire System Server node (3 digits).
date	Current date (YYYYMMDD).
time	Current time (HHMMSS).

UNIX

All work files created by Entire Operations reside in the directory $EOR_WORK or one of its subdirectories.

The environment variable EOR_WORK is set during the installation of Entire System Server for UNIX. This variable may contain any valid directory name. The default is $NPDDIR/$NPRVERS/work. See also Establish Environment Variables in the section Installing Entire System Server (NPR) on UNIX in the Entire System Server documentation.

The directory $EOR_WORK should have the access drwxrwxrwx because its subdirectories may belong to various UNIX owners and groups. Ensure that enough space for work file creation is available.

UNIX work files are created with the following names:

$EOR_WORK/unix-userid/dbid-fnr/owner/network/run-upper/run-lower/owner/job.extension

The name of the work directory for an active network is available in the pre-defined symbol P-NADIR (see Table of Predefined Symbols in the User's Guide). Application-specific work files may be stored there, as long as there are no name conflicts with files generated by Entire Operations.

Work files created by Entire Operations and by the application are deleted during the network or job deactivation by the Entire Operations monitor.

UNIX Work File Extensions

Extension	Explanation
current.sysout.txt	Current SYSOUT file.
01.sysout.txt through 99.sysout.txt	Previous SYSOUT files.
current.sh	Shell script which was actually submitted.
current.sh.pid	File containing the process ID of the shell script.
current.frame.sh	Shell script frame.

Notes:

1. Since owner, network and job are defined in upper case within Entire Operations, they also appear in upper case in the generated file names.
2. The access rights of the UNIX work files and of the intermediate directories depend on the UMASK setting of the Entire System Server for UNIX. You may insert a UMASK statement into the Entire System Server for UNIX startup script (for example Startups).

Windows

All work files created by Entire Operations reside in the directory %EOR_WORK% or one of its subdirectories.

The environment variable EOR_WORK is set during the installation of Entire System Server for Windows.

Windows work files are created with the following names:

%EOR_WORK%\userid\dbid-fnr\owner\network\run-upper\run-lower\job.extension

Windows Work File Extensions

Extension	Explanation
current.frame.bat	Frame batch file. This frame invokes the executable batch file or a directly executable program.
current.bat	Executable batch file
current.sysout.txt	Current SYSOUT file.
01.sysout.txt through 99.sysout.txt	Previous SYSOUT files.

Note:
Since owner, network and job are defined in upper case within Entire Operations, they also appear in upper case in the generated file names.

File Name Generation Exit

It is possible to generate work file names using a generic logic (an exit). For this purpose, all generated file names must be unique.