sezam installation manual - sezam dba …sezdata.com/sites/default/files/manuals/00i312e.pdfsez312m...

SEZAM

INSTALLATION MANUAL

SEZAM Installation Manual

2

Manual Order Number: SEZ312-00I312E This document is applicable to SEZAM Version 3.1.2 and to all subsequent releases, unless otherwise indicated in new editions or technical newsletters. Specifications contained herein are subject to change and these changes will be reported in subsequent revisions or editions. Readers’ comments are welcome. Comments may be directed to: E-mail: [email protected] www.sezdata.com © November 2011, Konstantin Soumm All rights reserved Use permissible by license only Printed in the Federal Republic of Germany The name SEZAM is either trademark or registered trademark of Konstantin Soumm and/or his licensors. Other company and product names mentioned herein may be trademarks of their respective owners.

The SEZAM documentation often refers to numerous hardware and software products by their trade names. In most, if not all cases, these designations are claimed as trademarks or registered trademarks by their respective companies.


3

TABLE OF CONTENTS 1. Supported System Environments........................................................5 2. Contents of the Installation Tape .......................................................6 Prerequisites ..........................................................................................6 Installation Tape Description ....................................................................6 3. Which Installation Method? ...............................................................7 4. First-Time Installation ........................................................................8 Step 1 Load SEZAM System File .............................................................8 Step 2 Load SEZAM System Programs .....................................................8 Step 3 Load SEZAM Updated System Programs .........................................8 Step 4 Copy User Exits ...........................................................................9 Step 5 Specifying NATURAL Parameters ..................................................9 Step 6 NATURAL Security Considerations ................................................10 5. Upgrading from a Previous Version ..................................................11 Step 1 Load SEZAM System File..............................................................11 Step 2 Refresh SEZAM 3.1.2 System File .................................................11 Step 3 Backup SEZAM Settings ...............................................................12 Step 4 Scratch SEZAM System Library .....................................................12 Step 5 Load SEZAM System Programs .....................................................12 Step 6 Load SEZAM Updated System Programs .........................................13 Step 7 Copy User Exits ...........................................................................13 Step 8 Restore SEZAM Settings ...............................................................13 Step 9 Migrate the Data ...........................................................................14 6. Initializing SEZAM System Environment .........................................15 7. Starting SEZAM for the First Time ...................................................16 Creating the Initial User ...........................................................................17


4

8. Setting Defaults ..................................................................................18 User Exit SN00UEX1 ..............................................................................18 User Exit SN00UEX2, SN00UEX4 ...........................................................21 9. Applying Early Warnings ..................................................................24 10. Operating SEZAM – Environment-Specific Information ...............25 SEZAM under z/VM ...............................................................................25 Submitting of the REXX .....................................................................25 Output Processing ..............................................................................26 SEZAM in Batch Mode ...........................................................................26 Using SEZAM with TP Monitors ..............................................................26 SEZAM under COM-PLETE ...............................................................27 SEZAM under TSO ...........................................................................27 SEZAM under CICS z/OS...................................................................28 SEZAM under CICS z/VSE.................................................................28


5

SEZAM INSTALLATION MANUAL

1. Supported System Environments Before attempting to install SEZAM, ensure that the host and database operating environments are at the minimum required level, as shown below. SEZAM is available for the following database environments: ∗ ADABAS Version 8.1 or higher ∗ NATURAL Version 4.2 or higher SEZAM is available for the following operating environments: ∗ Fujitsu BS2000/OSD ∗ IBM z/OS ∗ IBM z/VM ∗ IBM z/VSE


6

2. Contents of the Installation Tape

Prerequisites ADABAS Version 8.1 or higher and NATURAL Version 4.2 or higher must be installed.

Installation Tape Description The installation tape contains the datasets listed in the table below. The sequence of the datasets is shown in the Report of Tape Creation which accompanies the installation tape. Dataset Description SEZvvv.SYSF SEZAM system file SEZvvv.INPL SEZAM system objects and error messages SEZvvv.Iccc SEZAM updated objects The notation vvv in dataset names represents the version number of the product. The notation ccc in dataset names represents the product correction number. The dataset type and the space each dataset require on disk is shown in the Report of Tape Creation.


7

3. Which Installation Method?

The installation method you chose depends on whether SEZAM is already installed at

your site. There are two methods available: first-time installation and inplace conversion.

First-Time Installation If you are installing SEZAM for the first time or in an environment where SEZAM is not yet installed, go straight to section First-Time Installation. Upgrading from a previous Version SEZAM version 3.1.1 can be upgraded to a new version of SEZAM 3.1.2 (see section Upgrading from a previous Version).


8

4. First-Time Installation

Step 1 Load SEZAM System File

Load the SEZAM 3.1.2 system file contained in data set SEZ312.SYSF using the Adabas utility ADALOD. Use the following options in this ADALOD step: ADALOD LOAD FILE=file ADALOD NAME='SEZ312-SYSF' ADALOD DSSIZE=10 ADALOD UISIZE=70B ADALOD NISIZE=100B ADALOD MAXISN=10000 ADALOD ISNSIZE=3 ADALOD ISNREUSE=YES ADALOD DSREUSE=YES ADALOD ASSOPFAC=10 ADALOD DATAPFAC=10 ADALOD SORTSIZE=sss ADALOD TEMPSIZE=ttt

Note: SEZAM system file is delivered with compressed record lenth 5060 bytes and it may only be loaded into Adabas databases installed on devices with data block size

more or equal to 3390 IBM device, for example: 8390 (IBM systems) or 2002 (Siemens).

Step 2 Load SEZAM System Programs

The SEZAM system programs are contained in the data set SEZ312.INPL and are loaded to your Natural system file (FNAT) using the Natural utility INPL. This data set also contains the SEZAM error messages.

Step 3 Load SEZAM Updated Programs

The SEZAM updated system programs are contained in the data set SEZ312.Iccc and are loaded to your Natural system file (FNAT) using the Natural utility INPL. This data set also contains the SEZAM error messages.


9

Step 4 Copy User Exits

Copy Natural User Exit USR0330N from the library SYSEXT to SYSSEZ using the SYSMAIN utility of NATURAL and rename it to SN000330. Copy Natural User Exit USR1005N from the library SYSEXT to SYSSEZ using the SYSMAIN utility of NATURAL and rename it to SN001005. Use the following options in this SYSMAIN step: SYSMAIN COPY,C,USRxxxxN,FM,SYSEXT,% TO,SYSSEZ FIN

Step 5 Specifying NATURAL Parameters

Whenever you invoke online NATURAL to work with SEZAM or operate with SEZAM utilities in batch, do either of the following:

* Append the following macro definitions: NTFILE ID=133,DBID= dbid,FNR=fnr-sysfile

in your NATURAL parameter module, where: - dbid is your database ID; - fnr-sysfile is the file number where you loaded the SEZAM system file. Then re-assemble and re-link the NATURAL parameter module. OR:

* Use the dynamic parameters:

LFILE=(133, dbid, fnr-sysfile)

Specify the following parameters: DATSIZE=120 ESIZE=64 MADIO=0 MAXCL=0

The PRINTER parameter should allow for at least 1 printer in online. Depending on the TP environment the specification: RJESIZE=32 may also be necessary.


10

Step 6 NATURAL Security Considerations

When using SEZAM under NATURAL security, the following prerequisites must be kept:

* The library SYSSEZ must be defined in NATURAL security * All libraries from which SEZAM have to be called must have the SYSSEZ library in

their steplib definitions


11

5. Upgrading from a Previous Version

The upgrading from a previous version will result in considerable modifications to the internal structure of your system file. We recommend backing up your SEZAM system file before executing the following installation steps using the backup procedures usually performed in your environment. Step 1 Load SEZAM System File

Load the SEZAM 3.1.2 system file contained in data set SEZ312.SYSF using the Adabas utility ADALOD. Use the following options in this ADALOD step: ADALOD LOAD FILE=file ADALOD NAME='SEZ312-SYSF' ADALOD DSSIZE=10 ADALOD UISIZE=70B ADALOD NISIZE=100B ADALOD MAXISN=10000 ADALOD ISNSIZE=3 ADALOD ISNREUSE=YES ADALOD DSREUSE=YES ADALOD ASSOPFAC=10 ADALOD DATAPFAC=10 ADALOD SORTSIZE=sss ADALOD TEMPSIZE=ttt

Note: SEZAM system file is delivered with compressed record lenth 5060 bytes and it may only be loaded into Adabas databases installed on devices with data block size

more or equal to 3390 IBM device, for example: 8390 (IBM systems) or 2002 (Siemens). Step 2 Refresh SEZAM 3.1.2 System File

Refresh the SEZAM 3.1.2 system file to the empty status with ADADBS ADABAS utility Use the following options in this ADADBS step: ADADBS REFRESH FILE=file


12

Step 3 Backup SEZAM Settings

Create backup copy of the SEZAM user exits: - SN00UEX1 - SN00UEX2 - SN00UEX4

Step 4 Scratch SEZAM System Library

Delete modules from the previous installation using NATURAL utility SYSMAIN. Use the following options in this SYSMAIN step: SYSMAIN DELETE,ALL,*,IN,SYSSEZ,% DBID, dbid,FNR, fnat FIN

Delete error messages from the previous installation using NATURAL utility SYSMAIN. Use the following options in this SYSMAIN step: SYSMAIN DELETE,ERROR,1,THRU,9999,IN,SYSSEZ,% DBID, dbid,FNR, fnat,% LANG,* FIN

Step 5 Load SEZAM System Programs

The SEZAM system programs are contained in the data set SEZ312.INPL and are loaded to your Natural system file (FNAT) using the Natural utility INPL. This data set also contains the SEZAM error messages.


13

Step 6 Load SEZAM Updated Programs

The SEZAM updated system programs are contained in the data set SEZ312.Iccc and are loaded to your Natural system file (FNAT) using the Natural utility INPL. This data set also contains the SEZAM error messages.

Step 7 Copy User Exits

Copy Natural User Exit USR0330N from the library SYSEXT to SYSSEZ using the SYSMAIN utility of NATURAL and rename it to SN000330. Copy Natural User Exit USR1005N from the library SYSEXT to SYSSEZ using the SYSMAIN utility of NATURAL and rename it to SN001005. Use the following options in this SYSMAIN step: SYSMAIN COPY,C,USRxxxxN,FM,SYSEXT,% TO,SYSSEZ FIN

Step 8 Restore SEZAM Settings

Restore SEZAM settings from the backup copy. The settings must be copied manually from the user exits SN00UEX1, SN00UEX2 and SN00UEX4


14

Step 9 Migrate the Data

This job converts SEZAM 3.1.1 data to Version 3.1.2 format and stores it on the SEZAM 3.1.2 system file. Start online NATURAL with the following parameters: LFILE=(132, dbid, fnr-sez311-sysfile) LFILE=(133, dbid, fnr-sez312-sysfile) where: - dbid is your database ID - fnr-sez311-sysfile is the file number of the SEZAM 3.1.1 system file; - fnr-sez312-sysfile is the file number of the SEZAM 3.1.2 system file; Migrate SEZAM 3.1.1 data using the SEZ312M migration routine of SEZAM. Use the following options in this step: LOGON SYSSEZ SEZ312M US SEZ312M EN SEZ312M RU SEZ312M HI SEZ312M SA SEZ312M PA SEZ312M TT FIN


15

6. Initializing SEZAM System Environment

If this is the first time you have installed SEZAM, or you have loaded a new NATURAL System File, start online NATURAL session with dynamic parameters DD and TD set to zero and perform the following initialising steps: # Logon to the NATURAL application, which steplib includes SYSSEZ library and enter SEZAMINS at the NEXT prompt. The SEZAM installation screen is shown in Figure 6-1. # Enter the valid SEZAM installation parameters: Parameter Description Required/Optional CUSTOMER Customer name PASSWORD Customer password, which you Required received from SEZAM support After the successfully installation the following message is displayed: SEZ0161: SEZAM installed successfully 13:50:07 ---------------- DBA Workbench Installatio n -------------- 2011-02-01 SSSSSSSS EEEEEEEE ZZZZZZZZZ AAAAA AAAAA MM MMM SS SS EE ZZ AA AA MMM MMMM SS EE ZZ AA AA MM MM MM MM SSSSSSSSS EEEEEE ZZ AAAAAAAAA AA MM MM MM MM SS EE ZZ AA A A MM MMM MM SS SS EE ZZ AA AA MM M MM SSSSSSSS EEEEEEEE ZZZZZZZZ AA AA MM MM II NN NN SSSSS TTTTTTT AAAAAAA LL LL II NNN NN SS TT AA AA L L LL II NN N NN SSS TT AAAAAAAAA LL LL II NN NNN SS TT AA AA LL LL II NN NN SSSSS TT AA AA LLLL LLL LLLLLLL A P R O D U C T OF K O N S T A N T I N S O U M M Customer ===> Software AG Password ===> Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF 8---PF9---PF10--PF11--PF12-- Help Exit Copyright

Figure 6-1: SEZAM Installation Screen


16

7. Starting SEZAM for the First Time To start SEZAM, logon to the NATURAL application which steplibs include the SYSSEZ library and enter SEZAM at the NEXT prompt. The introductory screen for the ADMINISTRATOR is shown in Figure 7-1. 14:02:57 --------------------- DBA Workbench ------ ---------------- 2011-02-01 Command ===> SSSSSSSS EEEEEEEE ZZZZZZZZZ AAAAAA AAAA MM MMM SS SS EE ZZ AA AA MMM MMMM SS EE ZZ AA AA MM MM MM MM SSSSSSSSS EEEEEE ZZ AAAAAAAAAA A MM MM MM MM SS EE ZZ AA AA MM MMM MM SS SS EE ZZ AA AA MM M MM SSSSSSSS EEEEEEEE ZZZZZZZZ AA AA MM MM Version 3.1 SM Level 0002 A P R O D U C T O F K O N S T A N T I N S O U M M User name ===> KSM User type ===> A(dministrator) Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8 ---PF9---PF10--PF11--PF12-- Help Exit Copyright

Figure 7-1: SEZAM Introductory Screen


17

Creating the Initial User SEZAM initial user is automatically created by the first logon to SEZAM. This user receives the following settings: Parameter Description Value USER NAME Name of initial user Natural system variable *USER INITIAL USER Initial user indication Y(es) USER INFO User specific JCL information Quoted USER NAME value USER TYPE Type of initial user A(dministrator) AUTHORIZATION Authorisation to process Y(es) SEZAM maintenance DATE OF CREATION Date of initial user creation Date DDDD/MM/YY format CREATED BY Name of user who has created *USER the initial user The initial user can not be deleted. After successfully creating of the initial user the following message is displayed: SEZ0050: Initial user created successfully


18

8. Setting Defaults User exit SN00UEX1 SEZAM user exit program SN00UEX1 provides a way to control the list of all available user specific non-SEZAM commands in the following format: #CMD-NAME #CMD-DESC #CMD-OFFS #CMD-THRE #CMD-AUTH 'SPF' Natural SPF

4 P

'SCAN' Natural SCAN

0 A

'HELP' Natural HELP

5 P

'CATALL' Natural CATALL

0 A

'PROFILE' Natural Security PROFILE

0 P

'GLOBALS' Natural GLOBALS

0 P

'LIST' Natural LIST

5 P

'SYS' Natural System Commands

3 A

Total number of user specific commands must not be bigger than 50.


19

The variables used in the user exit program have the following meaning: * #CMD-NAME - user specific command’s name * #CMD-DESC - user specific command’s description * #CMD-OFFS - number of characters of the user specific command which have to be identical to the entered command.

The #CMD-OFFS can assume the following settings: 0(Default) - the entered command must be equal to the command definition from the variable #CMD-NAME. For example, if the following settings are active: #CMD-NAME = ´LIST´ #CMD-OFFS = 0 only the LIST command without parameters is acceptable. N(Non zero) - only the first N characters of the entered command have to be

identical to the command definition from the variable #CMD-NAME.

For example, if the following settings are active: #CMD-NAME = ´LIST ´ #CMD-OFFS = 5

the LIST command with and without parameters is acceptable: LIST, LIST VIEW, LIST VIEW SEZ* etc.

* #CMD-THRE - threshold value for the corresponding command

The #CMD-THRE can assume the following settings: A - command can be executed by Administrator only M - command can be executed by Administrator and Mangers E - command can be executed by Administrator, Mangers and

Experts P( or blank) - command can be executed by every user

* #CMD-AUTH - name of user written which provides additional authorisation check. Routine must be written in NATURAL with the single parameter #RERSPONSE-CODE (P2). The routine must terminate with not zero response code if some conditions don't meet.


20

To change the defaults modify the NATURAL SN00UEX1 subprogram directly within the program listing in the defaults area: /* ================================================ ========== /* /* S E Z A M C O M M A N D S /* /* Change the description of the non-SEZAM Commands /* Total Commands Quantity must be less or equal 50 /* /* ================================================ ========== #CMD-NAME(1) := 'SPF ' /* NSPF #CMD-DESC(1) := 'Call NSPF' /* NSPF #CMD-OFFS(1) := 4 /* NSPF * #CMD-NAME(2) := 'SCAN' /* SCAN #CMD-DESC(2) := 'Natural SCAN' /* SCAN #CMD-THRE(2) := 'A' /* SCAN * #CMD-NAME(3) := 'HELP ' /* HELP #CMD-DESC(3) := 'Natural HELP' /* HELP #CMD-OFFS(3) := 5 /* HELP * #CMD-NAME(4) := 'CATALL' /* CATALL #CMD-DESC(4) := 'Natural CATALL' /* CATALL #CMD-THRE(4) := 'A' /* CATALL * #CMD-NAME(5) := 'PROFILE' /* PROFILE #CMD-DESC(5) := 'Natural PROFILE' /* PROFILE * #CMD-NAME(6) := 'GLOBALS' /* GLOBALS #CMD-DESC(6) := 'Natural GLOBALS' /* GLOBALS * #CMD-NAME(7) := 'LIST ' /* LIST #CMD-DESC(7) := 'Natural LIST' /* LIST #CMD-OFFS(7) := 5 /* LIST * #CMD-NAME(8) := 'SYS' /* SYS #CMD-DESC(8) := 'NATURAL System Commands' /* SYS #CMD-THRE(8) := 'A' /* SYS #CMD-OFFS(8) := 3 /* SYS

Figure 8-1: User exit program SN00UEX1 DEFINE DATA PARAMETER 01 #RESPONSE-CODE (P002) END-DEFINE RESET #RESPONSE-CODE IF *USER NE 'KSM2' THEN #RESPONSE-CODE := 4 END-IF END

Figure 8-2: Example of the authorisation routine


21

User exits SN00UEX2 and SN00UEX4 SEZAM user exit program SN00UEX2, SN00UEX4 provide a way to modify the default settings of the SEZAM system variables. The user exit SN00UEX2 must be kept in the SEZAM system library SYSSEZ and all settings done to it are valid for the all SEZAM users. To overwrite some of them copy the user exit SN00UEX4 to the private user's library and modify it. Here are the SEZAM system variables in the alphabetical order: #N-EDITOR Default type of NATURAL Editor:

'N' - Standard Source Editor 'I' - NSPF Editor

#S-CONFIRM Confirmation format Is used when the confirmation is set to active (see #S-CONFIRM-SU, #S-CONFIRM-GN variables later in this section): 'L' - long 'S' - short

#S-CONFIRM-GN Confirmation type by the processing of the GN(GENERATE) command: 'Y' - always confirm 'O' - confirm by overwrite 'N' - do not confirm

#S-CONFIRM-RE Confirmation type by the auto recovery processing: 'Y' - confirm 'N' - do not confirm

#S-CONFIRM-SU Confirmation type by the processing of the EX(EXECUTE), SU(SUBMIT) commands: 'Y' - confirm 'N' - do not confirm

#S-DD Processing type of the dataset allocation: 'A' - automatically 'R' - automatically with return 'M' - manually with PF12

#S-DD-DEFAULT Processing type of the dataset daefault allocation: 'A' - automatically 'M' - manually with PF4

#S-DD-ACCEPT Processing type of the dataset accept: 'A' - automatic, accept (PF6) and scroll to next dataset 'M' - manual, accept (PF6) and stay on the screen


22

#S-ENVP #S-HSTP #S-JOBP #S-PRMT #S-TRAP #S-USRP

Type of the scroll routine for the correspondent SEZAM object: 'S' - standard 'E' - enhanced

#S-GN-TYPE System reaction by the processing of the GN(GENERATE) command: 'G' - generate and return to SEZAM 'E' - generate and stay in NATURAL Editor

#S-HISTORY Status of the history facility: 'Y' - active 'N' - inactive

#S-HISTORY-GN Status of the history facility for the GN(GENERATE) command: 'Y' - active 'N' - inactive

#S-HISTORY-JCL Status of the history facility for the JCL / REXX processing: 'Y' - active, the generated and submitted JCL / REXX is saved in the history records 'N' - inactive

#S-HISTORY-LOG Status of the history facility for SEZAM logon records processing: 'Y' - active, the logon records are saved in the history records 'N' - inactive

#S-HISTORY-SEZ Status of the history facility for SEZAM system objects: 'Y' - active, all modifications of the SEZAM system objects are saved in the history records 'N' - inactive

#S-JCLNAME #S-JCLPREFIX

Default prefix and name for the generated JCL / REXX. The generated JCL / REXX is saved in the NATURAL text object with the name <#S-JCLPREFIX><#S-JCLNAME>, default: SJDUMMY

#S-JOBNAME Default name of the generated JCL / REXX Is sensitive if the job name rule is not defined in the correspondent environment, default: SEZAM

#S-PATNAME #S-PATPREFIX

Default prefix and name for the NATURAL add-ons patterns. The pattern is processed from the NATURAL text object with the name <#S-PATPREFIX><#S-PATNAME>, default: SADUMMY

#S-REPNAME #S-REPPREFIX

Default prefix and name for the SEZAM reports. The report is saved in the NATURAL text object with the name <#S-REPPREFIX><#S-REPNAME>, default: SRDUMMY


23

The current status of the settings can be controlled with the 'SOPT' SEZAM direct command. To change the defaults modify the NATURAL SN00UEX2 subprogram directly within the program listing in the defaults area, which looks as follows: /* ================================================ ========== /* N A T U R A L S W I T C H E S /* /* Define the parameters in CAPITAL letters /* /* ================================================ ========== /* /* Default type of Natural Editor /* 'N' - Natural Source Editor /* 'I' - Natural SPF Editor #N-EDITOR := 'N' /* /* /* ================================================ ========== /* S E Z A M S W I T C H E S /* /* Define the parameters in CAPITAL letters /* /* ================================================ ========== /* /* Default JES Job Name #S-JOBNAME := 'SEZAM' /* /* /* Default Generated JCL Prefix and Name: #S-JCLPREFIX := 'SJ' #S-JCLNAME := 'DUMMY' /*

Figure 8-3: User exit program SN00UEX2


24

9. Applying Early Warnings Every SM level contains a closing Early Warning number. For SEZAM version 3.1.2, the closing Early Warning number is 312XXX, where XXX is the number of the applied Early Warning. To check the list of the applied Early Warnings use the 'SZAP' SEZAM direct command: 14:04:25 ---------------- Applied source correction s -------------- 2011-02-01 Command ===> CM - Command help ................................................... .......................... 312001 312002 312003 312004 312005 312006 312007 312008 312009 312010 312011 312012 312013 312014 312015 312016 312017 312018 312019 312020 312021 312022 312023 312024 312025 312026 312027 312028 312029 312030 312031 312032 312033 312034 312035 312036 312037 312038 312039 312040 312041 312042 312043 312044 312045 312046 312047 312048 312049 312050 312051 312052 312053 312054 312055 312056 312057 312058 312059 312060 312061 312062 312063 312064 312065 312066 312067 312068 312069 312070 312071 312072 312073 312074 312075 312076 312077 312078 312079 312080 312081 312082 312083 312084 312085 312086 312087 312088 312089 312090 312091 312092 312093 312094 312095 312096 312097 312098 312099 312100 312101 312102 312103 312104 312105 312106 312107 312108 312109 312110 312111 312112 Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8 ---PF9---PF10--PF11--PF12- Help Exit

Figure 9-1: System information screen


25

10. Operating SEZAM - Environment-Specific Information

This chapter provides information that applies when using SEZAM in specific environments. SEZAM under z/VM This section contains special considerations that apply when running SEZAM under z/VM. Submitting of the REXX Processing of the SU(SUBMIT JCL/REXX) and EX(EXECUTE JCL/REXX) commands under z/VM has some peculiarities which are caused by the specific behaviour of the NATRJE (Natural Remote Job Entry) utility. The NATRJE utility is used in SEZAM to submit JCL/REXX cards to the operating system for scheduling and execution. Under z/VM the submitted cards are not forwarded directly to the operating system, but to the reader of the DBA, batch or user virtual machine. The destination can be re-directed using the CP SPOOL command: CP SPOOL PUNCH TO <virtual_machine/*> An example of SEZAM calling procedure can be seen in the Fig. 10-1. SEZ EXEC E1 V 130 Trunc=130 Size=27 Line =0 Col=1 Alt=0 ====> !...+....1....+....2....+....3....+....4....+ ....5....+....6....+....7... 00000 * * * Top of File * * * 00001 /* ****************************************** *********************** */ 00002 /* Call Sezam */ 00003 /* */ 00004 /* ****************************************** *********************** */ 00005 say 'Enter the RJE destination' 00006 parse upper pull punch_to 00007 00008 natprm = '' 00009 aprm. = 'NDEF' 00010 aprm.1 = 'steplib=syssez' 00011 aprm.2 = 'maxcl=0' 00012 aprm.3 = 'madio=0' 00013 aprm.4 = 'pc=on' 00014 aprm.5 = 'lfile=(133,19990,17)' 00015 aprm.6 = 'work=((1-7),am=pc)' 00016 aprm.7 = 'esize=120' 00017 aprm.8 = 'stack=(logon sezam;sezam)' 00018 DO I = 1 TO 99 00019 IF aprm.I <> 'NDEF' THEN DO 00020 IF i = 1 THEN natprm = natprm !! aprm.i 00021 IF i > 1 THEN natprm = natprm !! ',' !! a prm.i 00022 END 00023 END 00024 say 'Entering S E Z A M / C M S ...' 00025 set cmstype ht 00026 'cp spool punch to '!!punch_to 00027 NAT31 natprm 00028 * * * End of File * * *

Figure 10-1: SEZAM Call under z/VM


26

Output Processing The missing of the JES spool mechanism under z/VM makes the handling of the output of the ADABAS/NATURAL utilities different from those systems where the spool processing is a part of the operating system. The output of the ADABAS/NATURAL utilities is created in a form of CMS files and can be viewed with the CMS BROWSE command: BROWSE <fname ftype fmode> An example of the NATURAL program doing a browse of the CMS file is provided on the SEZAM installation tape and is called SPXXCMS1. The program can be customized and implemented in SEZAM using the user exit 1. SEZAM in Batch Mode SEZAM is an on-line application and is not supposed to be used in batch mode. Some operations over the SEZAM system objects have to be done in batch with SEZAM utilities. For more information about SEZAM utilities refer to SEZAM Utilities Manual. Using SEZAM with TP Monitors In a TP monitor environment, SEZAM operates as a standard NATURAL TP program and follows the rules that apply to programs executing under the control of this TP monitor. The subject of this section is to describe the differences in z/OS JES, or z/VSE POWER spool file processing in the various TP monitor environments. The spool file contains the records which are necessary to generate and review the job’s output. The processing of the spool file records appears to be a vital problem when running SEZAM in a single screen TP monitor system, i.e. without special session manager software; such software allows you to run the SEZAM in one session and to review the job’s output in the other one.

Another possibility to handle the problem in a very elegant way is to use the Software AG Entire System Server which makes operating system information and system services available to the user.


27

SEZAM under COM-PLETE Since the Parallel Transaction Utility COM-PASS provides an opportunity to start and suspend a transaction without need shut down other transactions, it turns out to be not a problem of separating the SEZAM session from the other with the System Job Queue Display UQ utility is running (Fig. 10-2). 12:06:25 TID 19 -DAEFCO- User KSM1 18.09.03 -- COM-PASS -- USTS Suspended Programs Program Services --------------------------------- ----------- ---------------------------- Programs Name C Level PF Service Des cription Programs ID PF -------- -------- - ----- -- ----------- --------- -------- -- -- NAT31 SEZAM L 1 * 01 DATASET HAN DLER UDS A UQ L 2 02 PDS HANDLER UPDS B 3 03 Utilities M enu UUTIL C 4 04 OS JOB QUEU ES UQ D 5 05 FULL SCREEN EDITOR UEDIT E 6 set YOUR li brary IDS ULIBID F 7 ENQS DISPLA Y UENQ G 8 NATURAL SPF -EDITOR NSPF31 H 9 Enter Input: HELP ? --------------------------------------------------- ---------------------------- LU Name: TPXGE006 HC TID: Recall : = Language: 001 Devtype: 3279 VS Device: DAEPRTB1 Suspend : < PF23 Case : LOWER Lines : 24 Key: PA1 Jump : NO NO Columns: 80

Figure 10-2: COM-PASS screen SEZAM under TSO The SDSF (System Display and Search Facility) used together with an ISPLINK interface makes it possible to implement in SEZAM a user-written routine for the JES Spool file processing. An example of such routine is provided on the SEZAM installation tape and is called SPXXTSO1. The program can be implemented in SEZAM using the user exit 1.


28

SEZAM under CICS z/OS The JES spool file processing under z/OS is done with the SDSF (System Display and Search Facility) which is available in TSO. The JES spool file processing from SEZAM under CICS can be realized in a following way:

- starting of the two separate mainframe terminal sessions (SEZAM under CICS and SDSF under TSO)

- using a user-written NATURAL CICS interface program making an access to the JES spool file

SEZAM under CICS z/VSE The spool file handling under z/VSE is subject of VSE/Interactive Computing and Control Facility (VSE/ICCF) which allows you to run the jobs in VSE partitions. The print output from a job can be disposed of in several ways. It can be routed to your terminal, into your print area, or into a library member. The JES spool file processing from SEZAM under CICS can be realized in a following way:

- defining of ICCF and production CICSs and starting of the two separate mainframe terminal sessions (SEZAM in a production CICS and ICCF in a ICCF CICS)

- using a user-written NATURAL CICS interface program making an access to the POWER spool file


29

Notes


30

Notes

sezam installation manual - sezam dba …sezdata.com/sites/default/files/manuals/00i312e.pdfsez312m...

Documents