Home

SEZAM ADMINISTRATION MANUAL

1. NR PROGNAME 1 ADAACK 2 ADACDC 3 ADACMP COMPRESS 4JADACMP DECOMPRESS 5 ADACNV CONVERT G ADACNV REVERT 7 ADADBS ADD 8 ADADBS ALLOCATE 9 ADADBS CHANGE LOJADADBS CVOLSER 11 ADADBS DEALLOCATE 12 ADADBS DECREASE 13 ADADBS DELCP 14 ADADBS DELETE 15 ADADBS DSREUSE 16 ADADBS ENCODEE 17 ADADBS INCREASE 18 ADADBS ISNREUSE 19 ADADBS MODFCB 20 ADADBS NEWALTS 21 ADADBS NEWFIELD 22 ADADBS ONLINVERT 23 ADADBS ONLREORFASSO 24 ADADBS ONLREORFDATA 25 ADADBS ONLREORFILE 26 ADADBS OPERCO 2 7 ADADBS PRIORITY 28 ADADBS RECOVER 29 ADADBS REFRESH 30 ADADBS REFRESHSTATS 31 ADADBS RELEASE 32 ADADBS RENAME 33 ADADBS RENUMBER 34 ADADBS RESETDIB 35 ADADBS TRANSACTIONS 36 ADADBS UNCOUPLE 37 ADADCK 38 ADADEF DEFINE 39 ADADEF MODIFY 4O JADADEF NEWWORK 41 ADAFRM ASSOFR 42 ADAFRM ASSORESET 43 ADAFRM CLOGFR 44 ADAFRM DATAFR 45 ADAFRM DATARESET 4 6 ADAFRM DSIMFR 133 SEZAM Administration Manual
2. 47 ADAFRM DSIMRESET 48 ADAFRM PLOGFRM 49 ADAFRM RLOGFRM SOJADAFRM SORTFRM SIJADAFRM TEMPFRM 52 ADAFRM WORKFRM 53 ADAFRM WORKRESET 54 ADAICK SS5 ADAINV COUPLE S6 ADAINV INVERT 57 ADALOD LOAD 58jADALOD UPDATE 59 ADAMER GOJADAORD REDB 61 ADAORD REF 62 ADAORD REORASSO 63 ADAORD REORDATA 64 ADAORD REORDB 65 ADAORD REORFASSO 66 ADAORD REORFDATA 6 7 ADAORD REORFILE 68 ADAORD RESTRUCTUREDB 69 ADAORD RESTRUCTUREE 7OJADAORD STORE TLJADAPLP 72 ADAPRI 73 ADARAI CHKDB 74 ADARAI DISABLE 75 ADARAI LIST 76 ADARAI PREPARE 77 ADARAI RECOVER 78 ADARAI REMOVE 79 ADAREF AMIRROR 80 ADAREF DMIRROR 81 JADAREF DUPLICATE 82 ADAREF FILE 83 ADAREF NOMIRROR 84 ADAREF WMIRROR 85 ADAREP 86 ADARES BACKOUT 87 ADARES CLCOPY 88 ADARES COPY 89 ADARES PLCOPY 90 ADARES REGENERATE 91 ADARES REPAIR 92 ADARUN PROG USER 93JADASAV MERGE 94 ADASAV RESTONL 95 ADASAV RESTORE 134 SEZAM Administration Manual 96 ESTPLOG 97 98 99 100 H oj Qal wm w far D Q El 101 102 103 104 105 106 107 108 109 ATUNLD SCAN ELECT Pl p p pl e eee cof al a aia wn e EZDEL EZLIST 120 EZLOAD 123 MN n n WM Va EZUNLD 122
3. Utility specific parameter s component ADASAV SAVE FILES 18 ADASAV UTYPE EXU ADASAV NOUSERABEND The independent part can and must be defined in the description of the job stream As to dependent part it is impossible to provide it s definition because it receives the real values dynamically during the JCL REXX generation The possible solution is to use the break points which ensure the possibility of dynamic values substitution and make the generation process extremely flexible Break Points Here are the SEZAM break points in the alphabetical order Break Point Function Required Optional USERCB E Processing of ADABAS CLOGR datasets Required USERDB E Processing of ADABAS DSIMR dataset Required USERDD Processing of utility specific datasets DDSAVEI etc Required USERFB FE Processing of ADABAS FORMAT utility Required USERNB E Processing of NATURAL profile parameters Required USERN2B E Processing of NATURAL INPL system command Required USEROS VM ESA system indicator Optional USERPA Processing of utility specific parameter s Required USERPB E Processing of ADABAS PLOGR datasets Required USERRB E Processing of ADABAS RLOGR and RLOGM datasets Required USEROS VM ESA system indicator Optional USERSB E Processing of ADABAS single mode parameters Required USERTB E Processing of ADABAS SORT and TEMP datasets Required 12 SEZAM Administration Manual The actions take place by the processing of the break points are t
4. USERS execute UTILITIES access ENVIRONMENTS use ADABAS FILES Figure 2 5 SEZAM Objects and Relations 16 SEZAM Administration Manual Each NATURAL user who intends to operate with SEZAM should be registered in SEZAM 1 e user must be defined with one of the following user type authority classification E A Administrator M Manager E Expert P Person This classification pre determines the user s authorities of using the SEZAM objects ADMINISTRATOR may execute all utilities in all environments against all files Only ADMINISTRATOR with extra administration authority may execute the SEZAM administration functions 1 e create and modify users environments etc This user type is determined only for the SEZAM system administrators The ADMINISTRATOR without such authority may only browse through the various SEZAM objects MANAGER may use a great part of functions with the all files but only in the predefined environments This user type can be assigned to the people responsible for the ADABAS system maintenance only in the certain databases EXPERT may use a lot of functions with up to 50 predefined ADABAS files in the pre defined environments This user type is designed for the experienced ADABAS NATURAL developers PERSON may use a small part of functions with up to 50 predefined ADABAS files in the predefined environments Normally this is the standard user type w
5. SET FILE LINK CMPRMIN CMPRMIN MOD J SW ON 4 5 ASS SYSDTA SYSCMD START PROG EDT SCR 1 IM D AUTO 0FF DBID 2001 INTENS 1 STACK INPL SW CMPRMIN O SH MOD J SW OFF 4 5 SET JOB STEP ASS SYSDTA PRIMARY MOD J SW ON 2 START PROG DEMO NATPHSE ASS SYSOUT PRIMARY ASS SYSLST PRIMARY LOGOFF 125 SEZAM Administration Manual z OS GRS records for ADABAS JCL stream Prty Record Value 1 JCH A JOBNAME JOB 999 USERINFO CLASS W MSGCLASS X COMMENTS 2 SEZENV SEZENV MVS 3 NODE ROUTE XEQ MVS JOBPARM SYSAFF MVS ROUTE PRINT MVS 4 EX ADARUN SEZADA EXEC PGM ADARUN REGION 8000K TIME 1440 5 STEPLIB A STEPLIB DD DSN ADABAS VXXX MVSLOAD DISP SHR 6 USERFB 0 DDASSOR1 DDASSOR1 DD DSN DB333 ASSOR1 DISP SHR 1 DDDATAR DDDATAR1 DD DSN DB333 DATAR1 DISP SHR 2 DDWORKR DDWORKR1 DD DSN DB333 WORKR1 DISP SHR 3 USERPB 4 DDPLOGR DDPLOGR1 DD DSN DB333 PLOGR1 DISP SHR 5 DDPLOGR2 DDPLOGR2 DD DSN DB333 PLOGR2 DISP SHR 6 USERPE 7 USERRB 8 DDRLOGM DDRLOGM1 DD DSN DB333 RLOGM1 DISP SHR 9 DDRLOGR1 DDRLOGR1 DD DSN DB333 RLOGR1 DISP SHR 20 USERRE 22 USERTB 28 DDSORTR DDSORTR1 DD DSN DB333 SORTR1 DISP OLD 24 DDTEMPR1 DDTEMPR1 DD DSN DB333 TEMPR1 DISP OLD 25 USERTE 26 USERCB 27 DDCLOGR DDCLOGR1 DD DSN DB333 CLOGR1 DISP SHR 28 DDCLOGR2 DDCLOGR2 DD DSN DB333 CLOGR2 DISP SHR 29 USERCE 30 USERDB 31 DDDSIMR DDDSIMR1 DD DSN D
6. WAS SOS Od Environment maintenance Rename record 2003 08 11 Command gt els Environment gt DB002 Section gt RS Old record prta prtn values Record name gt JCH A Record prta gt 1 Record prti gt New record prta prtn values Record name gt JCL HEADER Record prta gt 1_ Record prtn gt 1_ acer 7129 SM 41 75 17 Si Pi al Ol P HETP Exit Figure 5 12 Rename Record Screen 43 SEZAM Administration Manual Delete Record To delete the record take the next steps Enter DE DELETE RECORD as direct command in the Command field on the screen with all records Fig 5 4 or as line command in the Co field against the appropriate record If the command was entered as direct command enter the name of the record to be deleted Fig 5 9 To confirm delete enter the name of the record Fig 5 13 After successfully processing the deleted record disappears from the list of the records Fig 5 8 and the following message is displayed SEZ0039 Record deleted successfully UGS Silke 2 gt 2 Environment maintenance Delete record AOS 04 1 Command gt 2 Herp Environment gt DB002 Section SES Please confirm delete with the name EX ADARUN gt EX ADARUN_ Enter PEI SiS Pin Sp Pt SS SP jm Pi a ir i er Pir laa Help Exit Figure 5 13 Delete Record Screen 44 SEZA
7. SO Environment gt DB001 Enter description record Hdr daea Application Development 0001 Contact persons KSM VN 0002 Comments 0003 Bookkeeping project 0004 0005 0006 0007 0008 0009 0010 0011 Enter PEI PER PES SSP PRN PrE PRI 12001 1 APE 2 Help Exit Refr Accept Figure 5 24 Create Description Screen 59 SEZAM Administration Manual Delete Description To delete the environment description take the following steps Enter DDE DELETE DESCRIPTION as direct command in the Command field on the environment list screen Fig 5 1 or as line command in the Co field against the appropriate environment If the command was entered as direct command enter the name of environment being deleted Fig 5 15 Enter the name of environment to confirm the delete of the description Fig 5 25 After successfully processing the following message is displayed SEZ0366 Description deleted successfully 17282824 Environment maintenance Delete description 2003 08 11 Command gt BR elo Please confirm delete with the name DB001 Rank Enter Price Pin 2 3 94 Se 5 27 in J 910 231111 PELA Help Exit Figure 5 25 Delete Description Screen 60 SEZAM Administration Manual 6 History Maintenance The history maintenance is the facility which monitoring and accounting of the certain events
8. 050 060 070 Enter PF1 PF2 PF3 PF4 PF5 PF6 PF7 PF8 PF9 PF10 PF11 PF12 Figure 6 7 Browse JCL Screen To re submit the job directly from the history facility enter the SU SUBMIT JOB direct command on the screen Fig 6 7 To export the job stored in the history records to the NATURAL text object enter the direct XP EXPORT command on the screen Fig 6 7 70 SEZAM Administration Manual 7 Parameter s List Maintenance This facility makes possible to show the user s activity in the parameter s list area and to perform the maintenance commands For more information about parameter s lists consult SEZAM User s Manual To invoke the SEZAM parameter s list maintenance enter on the SEZAM Maintenance menu Fig 3 3 in the Function field the corresponding number of the Parameter s list maintenance function 4 Parameter s list maintenance The list of parameter s list owners will be shown in the short format Fig 7 1 188458 25 5 52 Parameters list maintenance 7 List 2 ZOO SOG i Command gt SCROLL gt PAGE CM Command help Co User User User Quantity Name Type SEAS EHT M A il pS HEB M A 2 2 JNM A A 726 gt KSM A A 1754 KSM1 M A 12 ae MEN M A p 55 MTA P A il ae SAC A A 5 E SAGHWS M A 4 ses SAL A A NZS Total records gt 10 Enter l 1 Jaa Pa es Se SiN SSP H SP OSS gt 2 He
9. To provide this feature SEZAM must be able to recognise the type of the operating system or to generate the job stream based on the user pre defined job s description SEZAM provides the second way To ensure the correct processing SEZAM ADMINISTRATOR has to describe the job generation stream It must be done in the correct syntax terms of the correspondent operating system This description is kept in the SEZAM environment An environment contains records which are organised in two sections General Record Section GRS and Sample Record Section SRS The structure of the SEZAM environment is shown in Figure 2 1 SEZAM Environment GENERAL SAMPLE RECORD RECORD SECTION SECTION Record 1 Record 1 Record 2 Record 2 Record 3 Record 3 Record N Record M Figure 2 1 SEZAM Environment Structure SEZAM Administration Manual The difference between the General GRS and the Sample Record Section SRS is the following Each GRS record can have up to two priority entries PA priority in the ADABAS utilities job stream PN priority in the NATURAL utilities NATURAL system commands and NATURAL user programs job stream The records from GRS participate in the generation process in the sequence of their priority values PA or PN The SRS records don t take a part in the job generation The SRS records are optional There are no influence of SRS records on the job generation process The
10. function 2 Retrieval Utilities To get the actual settings of function thresholds execute the following Enter corresponding function code in the Function field on the SEZAM Retrieval menu Fig 3 4 1 Utilities The actual threshold settings are shown in Figure 10 1 NS AA T e atte ee RECIEVE VEA ENEE Sa 2003 08 13 Command gt SCROLL gt PAGE CM Command help ADACMP COMPRESS ADACMP DECOMPRESS ADADBS ADD ADADBS NEWALTS ADADBS INCREASE ADADBS DECREASE ADADBS ALLOCATE ADADBS CHANGE ADADBS DEALLOCATE ADADBS DELETE COMIDDUOBWNE elec ld do co lo das ARNO RE Total records gt 124 Enter Pin 2 sin 9 lt img SP Sit J Bin 2 112 Help Exit Refr Figure 10 1 Utility Threshold Information Screen 111 SEZAM Administration Manual The information shown in Figure 10 1 includes the following Information Description UTILITY FUNCTION Name of utility function THRESHOLD Threshold value of the utility function For more information about thresholds consult SEZAM Basic Principles section AUTHORIZATION Authorisation of the utility function Y is defined i e only the SEZAM Administrators granted to maintain SEZAM are authorised for the corresponding utility function N is undefined TOTAL RECORDS Total number of records 112 SEZAM Administration Manual Commands This function allows to trace the current commands threshold settings To get
11. gt USR002 DBOO1 E ii l 2 sin S aind jan ge SSP Si O O Perl y Help Exit Figure 4 8 Delete User Screen 32 SEZAM Administration Manual 5 Environment Maintenance The environment maintenance is the facility which provides definition modification browse and delete of SEZAM environments To invoke the SEZAM environment maintenance enter on the SEZAM Maintenance menu Fig 3 3 in the Function field the corresponding number of the Environment maintenance function 2 Environment maintenance All environment maintenance commands can be processed from the screen with the list of all environments Fig 5 1 The following commands can be executed Command Description CR DE CO RE Create Delete Copy Rename environment SC VE Mass update Verify environment GRS SRS Process GRS SRS section records CRU DRU Create Delete job name rule CDE DDE Create modify Delete description records UGS 224 Environment maintenance Environment list 2003 08 11 Command gt SCROLL gt PAGE CM Command help Co Env Description General Sample Jobname Date of Greated Record Record Rule creation by Section Section A001 daea Application Yes Yes Yes 20911115 543 A012 daea Application Yes Yes Yes 2000 02 09 KSMFSLOD A014 daea Application Yes Yes Yes 2000 02 09 KSMFSLOD A015 daea Application Yes Yes Yes 2000 02 09 KSMFSLOD A016 daea Application Yes Yes Yes 2000 02 09 KSMFSLOD A017 da
12. DP i gt LO Ser nl 2 Help Exit Figure 12 1 SEZAM Corrections 121 SEZAM Administration Manual 13 SEZAM Options The feature is designed for displaying SEZAM installation options together with the current system settings The product code is always to pass to SEZAM technical support by the reporting of the problems of any kind The SEZAM options are described in SEZAM Installation Manual To invoke the SEZAM options enter on the SEZAM Administration menu Fig 3 2 in the Function field the corresponding number of the Utilities function 5 Options The example of SEZAM options screen is shown in Fig 13 1 kagon o neee vaseedl kere eat eea 5 200 S La iil Command gt GN CM Command help Report destination Report name gt REPO1_ Product information Product code e SASA ZOOS RILATE 312008 Customer Software AG License e EULI System settings Natural editor ESTOS _ Default names _ Scroll processing _ Generate processing Dataset allocation Confirmation processing Puter rin Ji ln n lei Sein ipl i 2 Help Exit Figure 13 1 SEZAM Options The system settings are divided into groups Natural editor History facility etc To display the group settings select the corresponding group with non blank character or with cursor To generate the summary system report into Natural text object specify report name and execute GN
13. If the priority values PRTA PRTN are not entered this record will not participate in the generation process for the ADABAS and or NATURAL jobs Enter the value of the record Fig 5 3 After successfully processing the created environment appears in the list of SEZAM environments Fig 5 1 and the following message is displayed SEZ0026 Environment created successfully 34 SEZAM Administration Manual 15327539 Environment maintenance Create environment 200303 1L Command gt Enter environment to be created Environment gt DB002 Enter section and record name Section name gt GRS__ Record name gt JCH A__ Record prta Record prtn Neen A Pip Si Ss la O A EI Help Exit Figure 5 2 Create Environment Screen ES SOR SA 25 Environment maintenance Create record ADSL Command gt 2 ela Environment DB002 Section Record name Record prta RECO EA gt GRS JCH A Enter the record value JOBNAME JOB USERINFO CLASS A MSGCLASS X REGION 3M NOTIFY amp SYSUID COMMENTS sd SS eo p Y OS SOS PD se a a DU te OTS acer Al gt lar lt td ain 5 lt la GS it i By Set 1911 0327 111 231 2 Help Exit Figure 5 3 Create Record Screen 35 SEZAM Administration Manual Modify Environment The environment modification makes it possible to perform modification operatio
14. SEZULD SEZAM Users screen 120 SEZAM Administration Manual 12 SEZAM Corrections SEZAM Corrections can be used for tracing the currently applied corrections which can be the first point by investigating of the different problems by SEZAM technical support The SEZAM corrections are described in SEZAM Installation Manual To invoke the SEZAM corrections enter on the SEZAM Administration menu Fig 3 2 in the Function field the corresponding number of the Utilities function 4 Corrections The example of SEZAM correction screen is shown in Fig 12 1 16438813 Applied SEMELE corrections MU ANS 1172 Command gt CM Command help 312001 312002 312003 312004 312000 312006312007 312008 314009 312010 STADT SIZOT MZOS Leila 212015 312016 Ss 1201 S Z0 Sapo 312020 Sie 2 214022 aladas 312024 212025 3120726 S120d21 312028 212029 212030 312031 912032 912033 312094 212035 212036 2120591 312038 312039 312040 312041 312042 312043 312044 312045 312046 312047 312048 312049 312050 312051 314052 214095 S2054 2100551 912056 8120S ados S120959 SLOGO STADE 3124082 212063 312064 212065 212066 S12007 312068 312069 212090 310071 312072 312073 512074 312075 212076 212014 Sao res A079 312080 312081 312082 312093 3912084 312085 312086 312081 312008 3212089 312090 312091 312092 312093212094 310495 9120960 241209731 098 312099 Enter Trsce is Qa ei n
15. as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job Enter the old and new job names Fig 8 15 Parameter Description OLD JOB NAME Name of the saved job being renamed NEW JOB NAME New name of the saved job After successfully processing the new job appears in the list of the all jobs Fig 8 1 instead of the old one and the following message is displayed 5720235 Job renamed successfully ATO E ear Saved jobs maintenance Rename job 2003 08 12 Command gt 8 elo Enter saved job values Old job name gt SYSMAIN New job name gt SYSMAIN NEW mite gt Pins alang GSS J Pn I LO an er Help Exit Figure 8 15 Rename Saved Job Screen 96 SEZAM Administration Manual Submit Saved Job To submit the saved job to the operating system for execution perform the following Enter SU SUBMIT JOB as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job The SU direct command can also be issued on the Browse Saved Job Screen Fig 8 6 or on the Modify Saved Job Screen Fig 8 9 If the command was entered as direct command enter the name of the job being submitted Fig 8 5 Confirm submitting of the saved job to the operating system Fig 8 16 After
16. for example SEZUNLD Utility Enter the type of SEZAM object for the processing with the selected SEZAM Utility for example USERS Fig 11 2 Enter required and optional SEZAM Utility parameters on the functional screen Fig 11 3 The step can be processed with the help of parameter s list commands SA BR DE For information about parameter s list commands consult the section SEZAM Command in SEZAM User s Manual Out of necessity allocate the datasets which are required for some of SEZAM Utilities For example the SEZUNLD can require the CMWKF01 CMWKF02 and CMWKF03 For information about the dataset allocation consult the section ADABAS Maintenance in SEZAM User s Manual Enter the job processing command for the JCL REXX execution EX or generation GN For information about job processing commands consult the section SEZAM Commands in SEZAM User s Manual 119 SEZAM Administration Manual A DA RSE AMS SN SSeS AVOS O8 1 S Command gt CM Command help Parmlist destination Job destination Parmlist name gt SEZAM312 Job name gt DUMMY_ Utility parameters Environment AdarunMode Library User Password gt SEZAM312__ MULTI_ gt W312 011 KSM is User name User environment USCEREYPS User authorization Input delimiter Terminal commands gt des Enter PEL PRA gt 5 0 oS ei H SP 10 SP 2 Help Exit Defaults Alloc Figure 11 3
17. 16 Export Saved Job Screen 98 SEZAM Administration Manual AS O SS SPORE O Eo gei ANS 05 12 Command gt Environment F164 Program ADASAV SAVE The job processed successfully and job will be overwritten Please confirm exporting with Y gt Y Mare RE a PES PEA Ser PFO PEJ ein 11 0251 1 22 Help Exit Figure 8 18 Export Saved Job Confirmation Screen 99 SEZAM Administration Manual Delete Saved Job To delete the saved job from the SEZAM Saved Area execute the following steps Enter DE DELETE JOB as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job Confirm processing Fig 8 18 After successfully execution the following message is displayed SEZ0171 Job deleted successfully A aj ae et DATE SNC A ALO Sa 7 AVOS SO SZ Command II Vv Please confirm delete of the job with the name JCLOO1 gt JCL001 Dice PP l Bi Zap SSO a Se ll Urr il ei A Help Exit Figure 8 18 Delete Saved Job Screen 100 SEZAM Administration Manual Mass Update Saved Jobs To process scan and replace of the jobs in the SEZAM Saved Area execute the following steps Enter SC MASS UPDATE JOBS as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the selected job En
18. 94 e Sela LSP il 2 Help Exit Figure 9 8 Delete Translation Table 109 SEZAM Administration Manual Copy Translation Table By Name To copy the single Translation table with the given name of the t tables owner to the different name perform the following steps Enter CO COPY T TABLE as direct or line command Fig 9 2 Enter the source and target environment s names or leave one of the names empty if the global t table is processed Fig 9 9 After successfully processing the t table with the given name will disappear from the list shown in Fig 9 2 and the following message is displayed SEZ0432 T table copied successfully 15341821 Translation table maintenance Copy table 2003 08 13 Command gt Enter owner of the table being copied User name gt JKSM Environment Source gt F010 Target gt F044 Magee sain Pin jm Se ey GSP PE 110 SPET PFI Help Exit Figure 9 9 Copy Translation Tables By Name 110 SEZAM Administration Manual 10 Retrieval Functions The retrieval facility may be used to get the information about the objects defined to SEZAM and the existing relationships between them With the Retrieval you can not do any SEZAM maintenance you may only look at things To invoke the SEZAM retrieval enter on the SEZAM Administration menu Fig 3 2 in the Function field the corresponding number of the Retrieval
19. A016 A 999 10 26 eas M N A018 A 2000 04 25 JWG M N F009 A 2000 12 06 SOM A N 999 1 2 011 ES A M 999 JA 13 SIM p N F044 A 2021211 _ IED M N BS2000 1 A 2OOS Ol 2 1 A ELD M N BS2000 2 A AMO S OL Zil 2441259 M N MVS A 939921 Total records gt 40 Wines l P e J PASS Jee 10 1 2 Hel Exit Refr SE Figure 4 1 User List Screen 25 SEZAM Administration Manual Create User To create the user definition perform the following steps Enter CR CREATE USER command in the Command field on the user list screen Fig 4 1 Enter parameters of the user who has to be created Fig 4 2 Parameter Description Required Optional USER NAME Name of user to be created Required ENVIRONMENT Name of environment where Required for types M E P user have to be defined Don t enter for type A USER INFO User specific job information Optional corresponds to the FUSERINFO system variable in the environment description USER TYPE Type of user to be created Required If creating a user of type A specify an extra administrative authorisation If creating a user of type E or P enter up to 50 ADABAS files with which the user can operate in the current environment Fig 4 3 After successfully processing the created user appears in the list of SEZAM users Fig 4 1 and the following message is displayed E 0 User created successfully 26 SEZAM Administration M
20. ELSE OVE USERNAME TO OUTPUT END IF RESPONSE CODE 4 ESCAPE ROUTINE END 140 SEZAM Administration Manual Notes 141 SEZAM Administration Manual Notes 142
21. SRS records ensure the usage of the pre defined default datasets allocations by the JCL REXX generation and execution SEZAM provides separate control of the job generation stream for the ADABAS utilities and for all the other functions i e NATURAL utilities NATURAL system commands etc It is achieved by the separating of the priorities for the ADABAS job stream PA from the priorities for the NATURAL PN Each JCL REXX Fig 2 2 consists of two parts Independent part which is the same in all jobs Dependent part which is utility specific KSMFASAV JOB 999 KSM CLASS W MSGCLASS X SEZ312 F177 ADASAV Save files FILE 18 SEZENV F177 ROUTE XEO DAEF JOBPARM SYSAFF DAEF ROUTE PRINT DAEF STEP01 EXEC PGM ADARUN REGION 8000K TIME 1440 STEPLIB DD DSN RZDBA DB177 NEWLOAD DISP SHR Ji DD DSN RZDBA DB177 LOAD DISP SHR DDASSOR1 DD DSN DB177 SYSF ASSOR1 DISP SHR DDDATAR1 DD DSN DB177 SYSF DATAR1 DISP SHR DDWORKR1 DD DSN DB177 SYSF WORKR1 DISP SHR DDSAVE1 DD DSN ADASAV DAEF DB177 F018 DISP KEEP UNIT 3480 LABEL 1 SL EXPDT 98000 res VOL RETAIN SER KSM001 TRTCH COMP DDDRUCK DD SYSOUT DDPRINT DD SYSOUT DDCARD DD ADARUN PROG ADASAV ADARUN SVC 249 ADARUN DEVICE 3390 ADARUN MODE MULTI ADARUN DBID 177 DDKARTE DD ADASAV SAVE FILES 18 ADASAV UTYPE EXU ADASAV NOUSERABEND END GENERATION Figure 2 2 Example
22. SYSMAIN 123 SYSOBJH 124 SYSTRANS 135 SEZAM Administration Manual APPENDIX C Direct commands DIRECT DESCRIPTION THRESHOLD COMMAND ADA ADABAS maintenance menu P ADAACK ADAACK Check address converter M ADACDC ADACDC Changed data capture M ADACMP ADACMP Compress Decompress P ADACNV ADACNV Database conversion A ADADBS ADADBS Database services P ADADCK ADADCK Check data storage ADADEF ADADEF Database definition A ADAFR ADAFRM Format ADAICK ADAICK Check index AC ADAINV ADAINV Invert E ADALOD ADALOD Loader E ADAMER ADAMER ADAM estimation E ADAMTS ADAMTS Message test send ADAORD ADAORD Reorder ADAPLP ADAPLP Protection log WORK print ADAPRI ADAPRI Print selected blocks ADARAT ADARAI Recovery aid ADAREF ADAREF Reflective database ADAREP ADAREP Report P ADARES ADARES Restart ADARPL ADARPL PLOG replication replay ADARPP ADARPP Print TLOG records ADASAV ADASAV Save Restore ADASCR ADASCR Security ADASEL ADASEL Select protection data ADAULD ADAULD Unload P ADAVAL ADAVAL Validate database ADAZAP ADAZAP Modify datasets A ARF ADABAS EVENT REPLICATOR menu BR Browse parameter list P CD Browse global direct command list P CL Browse command list P iC Command help P DE
23. TO Date after before which the job can be submitted YYYY MM DD date blank not defined TIME FROM TO Time after before which the job can be submitted HH MM time blank not defined DATE TIME EXCEPT Sequence of date time restrictions processing Y rejects the jobs which satisfy the restrictions N accepts the jobs which satisfy the restrictions EXCLUSIVE BROWSE Exclusive rights of job s submitting browse Y only administrators can submit view the job USER LIST Names of the users up to 10 who are authorised to submit the current job blank all the users 81 SEZAM Administration Manual on the restrictions screen Fig 8 3 press PF6 to accept the restrictions After successfully processing the following message is displayed SEZ0191 Restrictions accepted successfully press PF3 to return to the create job screen On the create job screen Fig 8 2 press ENTER to create the job and confirm job creation Fig 8 4 After successfully processing the created job appears in the list of the saved jobs Fig 8 1 and following message is displayed SEZ0193 Job created successfully 15225303 Saved jobs maintenance Create job 2003 08 12 Command gt Enter job to be captured source Job name gt JCLOO1 Enter parameters of the saved job target Job name gt SYSMAIN Description gt COPY PROGRAMS MUB22 TO MUB22_ Disposition gt D
24. VAR DIAG 8 CP DETACH 0 I END CP LINK DB33333 200 200 MW NOT USED CP LINK DB33333 300 201 MW NOT USED CP LINK DB33333 400 202 MW NOT USED CP LINK DB33333 410 203 MW NOT USED CP LINK DB33333 420 204 MW NOT USED DATADEF DDASSOR1 DSN DB33333 ASS0 VOL ASS200 UNIT 200 DATADEF DDDATAR1 DSN DB33333 DATA VOL DAT300 UNIT 201 CMPRINT STATE JOBNAME CMPRINT T1 IF RC 0 THEN ERASE JOBNAME CMPRINT T1 CMPRINT JOBNAME CMPRINT T1 FILEDEF CMPRINT DISK CMPRINT DDCARD ef ARUN NDEF ARUN 1 ADARUN PROG PROG ARUN 2 ADARUN DEVICE 3390 ARUN 3 ADARUN MODE MODE ARUN 4 ADARUN DBID 33333 STATE JOBNAME DDCARD T1 IF RC 0 THEN ERASE JOBNAME DDCARD T1 DO I 1 TO 99 IF ARUN I lt gt NDEF THEN DO IF I 1 THEN lt A Z A gt lt A Z A gt ASSO DATA WORK SORT TEMP EXECIO 1 DISKW JOBNAME DDCARD T1 0 F 80 ELSE EXECIO 1 DISKW JOBNAME DDCARD T1 END END CARD DSN JOBNAME DDCARD MODE T DATADEF DDCARD CARD CMSYNIN Ef ASYN NDEE STATE JOBNAME CMSYNIN T1 IF RC 0 THEN ERASE JOBNAM DO I 1 TO 99 IF ASYN I lt gt NDEF THEN DO IF I 1 THEN EXECIO 1 DISKW JOBNAM ELSE EXECIO 1 DISKW JOBNAM END END CMSYNIN JOBNAME CMSYNIN FILEDEF CMSYNIN DISK CMSY NATPARM EE CMSYNIN T1 CMSYNIN T1 0 F 80 CMSYNIN T1 TI IN FINIS STRING E E af E e FINIS S
25. i e owner in the full format Fig 9 2 02250850 Translation table maintenance List full Z003 USES Command gt SCROLL gt PAGE CM Command help Co SEIS User Env Env T table name Status Status Type E KSM A Global KSM A Z103 A Local so KSM1 A Global PEMA A Global A PEMA A A187 A Local 0 TSR A 2103 A Local Total records gt 6 Enter PET PRIPA tajud ep BP nl O PRII RPE 2 Help Exit Refr Short Figure 9 2 Translation Table List Screen Full Format 103 SEZAM Administration Manual Create Translation Table To create the Translation table perform the following steps Enter CR CREATE TABLE as direct command in the Command field Fig 9 1 Fig 9 2 Enter parameters of the t table being created Fig 9 3 Parameter Description ENVIRONMENT Name of the environment where the t table is to define only for local t tables To select the environment from the list of the environments with no t tables defined issue the SE SELECT command Fig 9 3 TRANSLATE FROM TO entries which are searched and converted to the correspondent Translate to entries by the execution of EX SU SB commands After successfully processing the quantity of the created t table for the given user increases Fig 9 1 and following message is displayed SEZ0405 T table created successfully 14353834 Translation table maintenance Create table
26. maintenance Copy user 200308 01 Command gt Enter user to be copied source user User name gt USROO1 _ Environment gt DB001 lnea target user User name gt Environment gt DB002 ico 1 12 5 2 9 GSS JS 18 Pg Nn Len le 12 Help Exit Figure 4 7 Enter User Screen 31 SEZAM Administration Manual Delete User To delete the user definition perform the following steps Enter DE DELETE USER as direct command in the Command field on the user list screen Fig 4 1 or as line command in the Co field against the appropriate user If the command was entered as direct command enter parameters of the user who has to be deleted Fig 4 4 Parameter Description Required Optional USER NAME Name of user to be deleted Required ENVIRONMENT Name of environment where Required for types M E P user is defined Don t enter for type A Confirm delete with the name of the user and the name of the environment where user is defined only for user type M E P The example of confirmation screen is shown in Figure 4 8 After successfully processing the deleted user disappears from the list of SEZAM users Fig 4 1 and the following message is displayed SEZ0005 User deleted successfully C 192328 39 2 2 gt 3 User maintenance Delete user 2003 08 11 Command gt 2 el Please confirm delete with the name USR002 DB001
27. specified name are processed PRE prefix mode Parameter s lists with the specified prefix are processed After successfully processing the removed entry disappears from the list shown in Fig 7 2 and the following message is displayed SEZ0339 Parameter list s renamed successfully UG ZaQ eA lt e s Parameter s list maintenance Rename 2004 10 04 Command gt Enter old and new parameter s list names Old parmlist name gt D INST New parmlist name gt D INS Mode gt PRE Enter BEIE PR Sei ad Se SG it PRS RRO 201 0212 0120 Figure 7 8 Rename Parameter s Lists By Name Screen 78 SEZAM Administration Manual 8 Saved Job Maintenance This facility makes possible to store the jobs of common use in the separate area of SEZAM It allows to increase the performance by reducing the total number of execution of GN GENERATE JCL command Every saved job can be executed directly from the Saved Area of SEZAM The use of the saved job can be restricted by the data time of execution and or by people It can be very convenient to grant as an exception the execution of some ADABAS NATURAL utility to the user who is normally not authorised for it Regardless of the restrictions every saved job can be processed by Administrator To invoke the SEZAM saved job maintenance enter on the SEZAM Maintenance menu Fig 3 3 in the Function field the corresponding number
28. the values execute the following Enter corresponding function code in the Function field on the SEZAM Retrieval menu Fig 3 4 ZZ PSOODO The threshold settings are shown in Figure 10 2 10025 300 is Rell Command gt SCROLL gt PAGE CM Command help CL Browse command list CM Command help BR Browse parameter list DE Delete parameter list ED Edit generated job Execute the job GN Generate the job ID Show user identification LI List of generated jobs SA Save parameter list DMA ORO E E NNNNNNNNNN COMIDGHHBWNHE El gt fan Total records gt 118 SS 5 JS Sass 91217 9 ak SP a Help Exit Refr Figure 10 2 Command Threshold Information Screen 113 SEZAM Administration Manual The information shown in Figure 10 2 includes the following Information Description NAME DESCRIPTION TYPE THRESHOLD AUTHORIZATION TOTAL RECORDS 114 Name of the command Type of the command S system command D global direct command E site independent external command U user defined external command only visual part must be identical For more information about the commands of type U and refer to SEZAM Installation Manual section Threshold value of the command For more information about thresholds consult SEZAM Basic Principles section Authorisation of SEZAM command Y is defined i e commands of type S are available
29. 2003 08 13 Command gt Enter owner of the table being created User name gt KSM Environment gt F010 Translate from to SECRET__ PUBLIC acer Pin SS SP St J P ie LSP ler Help Exit Reset Figure 9 3 Create Translation Table 104 SEZAM Administration Manual Delete Translation Tables To delete all Translation tables of the t tables owner or of the user not more defined in the SEZAM perform the following Enter DE DELETE T TABLE as direct or line command Fig 9 1 Confirm processing with owner s name Fig 9 4 After successfully processing the removed entry disappears from the list shown in Fig 9 1 and following message is displayed SEZ0410 T table deleted successfully 15 03 44 Translation table maintenance Delete all tables 2003 08 13 Command gt 2 Heip Please confirm delete of 3 t tables with the name KSM ALL gt KSM ALL A IS A AS Pi POSS PET IPES Help Exit Figure 9 4 Delete Translation Tables 105 SEZAM Administration Manual Mass Update Translation Tables To scan and replace all Translation tables of the given owner take the following steps Enter SC MASS UPDATE T TABLES as direct or line command Fig 9 1 Fig 9 2 Confirm processing with owner s name Fig 9 5 After successfully processing the removed entry disappears from the list shown in Fig 9 1 and one of the follo
30. 8 lt e lt lt n lt ccccst User maintenance Enter user 200S 08 Is Command gt Enter user to be browsed User name gt USROO1 _ Environment gt DB001 Enter PEI Pa Pit 97 G12 in mi aim ml 2 Help Exit Figure 4 4 Example of Enter User Screen 28 SEZAM Administration Manual 15445206 User maintenance Browse expert person AOS Ii Command gt User name gt USROO1 User info gt USR001 DB0O01 USR001 User type gt 12 Environment gt DB001 Date of creation gt 2003 08 11 Created by gt KSM File list 13 17 SS A O O O ES Help Exit Figure 4 5 Browse Expert Person Screen 29 SEZAM Administration Manual Modify User To change the user definition perform the following steps Enter ED EDIT USER as direct command in the Command field on the user list screen Fig 4 1 or as line command in the Co field against the appropriate user If the command was entered as direct command enter parameters of the user which definition has to be modified Fig 4 4 Parameter Description Required Optional USER NAME Name of user to be modified Required ENVIRONMENT Name of environment where Required for types M E P user is defined Don t enter for type A Modify the desired user definition Fig 4 6 After successfully processing the following message is displayed SEZ0022 User modified s
31. A SU Submit generated job P SULD SEZAM Unload Utility A SULD EN SEZAM Environment Unload Utility A SULD HI SEZAM History Unload Utility A SULD PA SEZAM Parmlist Unload Utility A SULD SA SEZAM Saved Jobs Unload Utility A SULD TR SEZAM Table Unload Utility A SULD US SEZAM User Unload Utility A SUTL SEZAM Utilities A SZAP SEZAM Applied source corrections A 138 SEZAM Administration Manual APPENDIX D Example of the Job Name s Rule User Exit KKARKARKAKKKKKA KKK KKK KKK KKK KKK KKK KKK KKK KKK KKK KK KEK KKK KKK KKK KKK KKK ARA RARA Example of jobname rule userexit NAME UEXRULO2 TYPE N SUBPROGRAM AUTHOR KONSTANTIN SOUMM DATE 16 01 08 16 01 08 HISTORY 16 01 08 W312 089 created RESPONSE CODE 0 use the jobname rule specified in the environment ll the OUTPUT contains the username 4 do not use the jobname rule specified in the environment ul the OUTPUT contains the jobname k kk kkk KKK KKK KKK KKK KEK KKK KKK KKK KKK KKK KKK KKK KKK KK KKK KKK RARA RARA KARA RARA RA DEFINE DATA PARAMETER 01 RESPONSE CODE P002 Response code 0 output contains user name JA which is used in jobname JE rule i
32. APPENDIX A Examples of Environment Definition 123 BS2000 OSD ui da SU ha ta AAA AA asii 123 LO A SN 126 FIN Mi a ada 128 INS A AS A is 132 APPENDIX B FPROGNAME Values ccconncccnnncccnonnnccnnonacononinicononinon 133 APPENDIX C Direct Command ooccccnccncnoncnnnnnennnnnnanicanacnonononocnanannnnos 136 APPENDIX D Example of the Job s Name Rule User Exit 139 SEZAM Administration Manual SEZAM ADMINISTRATION MANUAL 1 Summary SEZAM Administration subsystem allows to perform the functions which are necessary for SEZAM maintenance These functions make it possible to create and modify the users to produce environment definitions to support history records to view threshold settings etc All SEZAM Administration functions are allowed only on the level of ADMINISTRATOR user For information about SEZAM user types consult the SEZAM User s Manual SEZAM Administration components are shown in Figure 1 1 SEZAM ADMINISTRATION SEZAM MAINTENANCE SEZAM RETRIEVAL SEZAM UTILITIES SEZAM CORRECTIONS SEZAM OPTIONS Figure 1 1 SEZAM Administration Components Briefly the components are SEZAM MAINTENANCE Performs SEZAM maintenance functions 1 e user creation environment definitions saved jobs support etc The overview of the SEZAM maintenance functions is shown in Figure 1 2 SEZAM RETRIEVAL Performs SEZAM
33. B 29 USERCE 30 USERDB 32 USERDE 45 USERFE 49 USERDD 50 DDDRUCK DDDRUCK STATE JOBNAME DDDRUCK T1 IF RC 0 THEN ERASE JOBNAME DDDRUCK T1 DRUCK DSN JOBNAME DDDRUCK MODE T ADDRESS CMS DATADEF DDDRUCK DRUCK 51 DDPRINT DDPRINT STATE JOBNAME DDPRINT T1 IF RC 0 THEN ERASE JOBNAME DDPRINT T1 PRINT DSN JOBNAME DDPRINT MODE T ADDRESS CMS DATADEF DDPRINT PRINT 52 REM001 DDCARD ARUN NDEF 53 ADARUN P ARUN 1 ADARUN PROG PROG ARUN 2 ADARUN DEVICE 3390 ARUN 3 ADARUN MODE MODE 54 ADARUN DB ARUN 4 ADARUN DBID 33333 55 USERSB 56 ADARUN PLG ARUN 5 ADARUN PLOGRO NO 57 USERSE 60 USERR2B 61 ADARUN RAI ARUN 6 ADARUN UEX2 ADAEX2 62 USERR2E 63 64 65 88 90 91 92 93 94 95 96 99 DDCARD WR1 DDCARD WR2 DDCARD REM002 USERPA DDKART WR1 DDKART WR2 DDKARTE EX ADARUN REST ADA1 REST ADA2 JCT SEZAM Administration Manual STATE JOBNAME DDCARD T1 IF RC 0 THEN ERASE JOBNAME DDCARD T1 DO I IF 1 TO 99 ARUN I lt gt NDEF THEN DO IF I 1 THEN EXECIO 1 DISKW JOBNAME DDCARD Tl 0 F 80 FINIS STRING ARUN I ELSE EXECIO 1 DISKW JOBNAME DDCARD T1 FINIS STRING ARUN I END END CARD DSN JOBNAME DDCARD MODE T DATADEF DDCARD CARD DDKARTE KE AKAR a INDEF STATE JOBNAME DDKARTE T1 IF RC 0 THEN ERASE JOBNAME DDKARTE T1 DO I IF L TO 29 AKAR I lt gt NDEF
34. B003 Section gt ALL Rule gt Y Description gt Y tel 21021394 annin nai e in lies 12 Help Exit Figure 5 17 Delete Environment Screen 48 SEZAM Administration Manual Rename Environment To rename the environment source to another target perform the following Enter RE RENAME ENVIRONMENT as direct command in the Command field on the environment list screen Fig 5 1 or as line command in the Co field against the appropriate environment Enter parameters of the source and target environments Fig 5 18 Parameter Description Required Optional SOURCE Name of environment which Required ENVIRONMENT records are to be copied TARGET Name of environment to which Required ENVIRONMENT records have to be copied After successfully processing the target environment appears in the list of environments Fig 5 1 and the following message is displayed SEZ0357 Environment renamed successfully 17208828 Environment maintenance Rename environment 219053 Lu Command gt Enter source environment to be renamed Environment gt DB001 Enter target environment Environment gt Enter PFI PERL Pree n a 5 27 P PrI 9110 2112 2 Help Exit Figure 5 18 Rename Environment Screen 49 SEZAM Administration Manual Mass Update Environment To process scan replace against the environment components do the following Enter SC MASS
35. B333 DSIMR1 DISP SHR 32 USERDE 45 USERFE 49 USERDD 50 DDDRUC DDDRUCK DD SYSOUT 51 DDPRINT DDPRINT DD SYSOUT 52 DDCARD DDCARD DD 53 ADARUN P ADARUN PROG PROG ADARUN SVC 249 ADARUN DEVICE 3390 ADARUN MODE MODE ADARUN DSF YES 54 ADARUN DB ADARUN DBID 333 55 USERSB 56 ADARUN PLG ADARUN PLOGRQ NO 57 USERSE 58 USERR2B 59 ADARUN RAI ADARUN UEX2 ADAEX2 60 USERR2E 88 DDKARTE DDKARTE DD 90 USERPA 99 JCT END GENERATION 126 SEZAM Administration Manual GRS records for NATURAL JCL stream PY EY 1 54 59 90 99 Record SEZENV NODE EX NATURAL USERNB NATPARM USERNE USERN2B INPL USERN2E STEPLIB N DDASSOR1 DDDATAR1 USERDD CMPRINT DDPRINT DDCARD ADARUN P ADARUN DB CMSYNIN USERPA JCT JOBNAME JOB 999 USERINFO CLASS W MSGCLASS X REGION 3M PLES ROU JOB ROU SEZDO SEZ SEZEN PA PA STE DDA DDD CMP DDP DDC ADARU ADARU ADARU ADARU ADARU ADARU CMS E NOTIFY 8SYSUID COMMENTS EZENV MVS TE XEQ MVS PARM SYSAFF MVS TE PRINT MVS Enter the Natural version NAT EXEC PGM NATBAT31 REGION 3M D RM IM D INTENS 1 RM STACK INPL AUTO OFF IM D INTENS 1 PLIB DD DSN NATURAL VXXX MVSLOAD DISP SHR SSOR1 DD DSN DB333 ASSOR1 DISP SHR ATAR1 DD DSN DB333 DATAR1 DISP SHR RINT DD SYSOUT RINT DD SYSOUT ARD DD N PROG PROG N SVC 249 N DEVICE 3390 N MODE MODE N DSF YES N DBI
36. D 333 YNIN DD ND GENERATION 127 SEZAM Administration Manual ZIVM GRS records for ADABAS REXX stream Prty Record 128 1 JCH A COMMENTS 2 SEZENV SEZENV VM SAY COMMENTS 3 USEROS VM 4 CMSSET TRACE OFF SET CMSTYPE HT CP SET IMSG OFF CP SET EMSG OFF 5 SET ADA1 COMMON SETTINGS SET FILEPOOL DAEXUSR ADADIR DB33333A ADA712 LOAD ADADIRDB DB33333A ADA712 DBA DB33333 ADDRESS CMS VMLINK DIR ADADIRDB lt A Z A gt PUSH NOTYPE ADDRESS CMS VMLINK DIR ADADIR lt A Z A gt PUSH NOTYPE 6 SET ADA2 SET STORECLR ENDCMD SET LDRTBLS 20 SET LOADAREA 20000 SETTXTLB NUCXDROP NUCXTNTS RELDD 7 ADALINK LINK DATABASE DO I 200 TO 225 VAR DIAG 8 CP DETACH 0 I END CP LINK DB33333 200 200 MW NOT USED ASSO CP LINK DB33333 300 201 MW NOT USED DATA 8 ADALINK2 CP LINK DB33333 400 202 MW NOT USED WORK CP LINK DB33333 410 203 MW NOT USED SORT CP LINK DB33333 420 204 MW NOT USED TEMP 9 USERFB 10 DDASSOR1 DATADEF DDASSOR1 DSN DB33333 ASS0 VOL ASS200 UNIT 200 11 DDDATAR1 DATADEF DDDATAR1 DSN DB33333 DATA VOL DAT300 UNIT 201 12 DDWORKR1 DATADEF DDWORKR1 DSN DB33333 WORK VOL WOR400 UNIT 202 13 USERPB 16 USERPE 17 USERRB 20 USERRE 22 USERTB 23 DDSORTR1 DATADEF DDSORTR1 DSN DB33333 SORT VOL SOR420 UNIT 203 24 DDTEMPR1 DATADEF DDTEMPR1 DSN DB33333 TEMP VOL TEM410 UNIT 204 25 USERTE 26 USERC
37. Delete parameter list P ED Edit generated job P EX Execute the job P EXIT Terminate SEZAM session P GN Generate the job P ID Show user identification P JOB Finished Jobs maintenance menu P JOB GN Finished generated JOBs P JOB SA Finished saved JOBs P LI List of generated jobs P MENU SEZAM main menu P 136 SEZAM Administration Manual AT ATURAL maintenance menu P CAT ATURAL Catall command P ERR ATURAL error messages maintenance P INP ATURAL INPL Utility M LOD Load NATURAL programming objects P OBJ ATURAL Object Handler P SCN ATURAL Scan command P SMA ATURAL object maintenance P SYS ATURAL system commands processing P TRS ATURAL SYSTRANS Utility P ULD Unload NATURAL programming objects P USR ATURAL user program processing P UTL ATURAL utilities processing P SA Save parameter list P SADM SEZAM Administration A SAOS SEZAM Online ADABAS Services B SCMP SEZAM Compare of Natural objects P SCHK SEZAM ADABAS Checkpoint Information P SDEL SEZAM Delete Utility A SDEL EN SEZAM Environment Delete Utility A SDEL HI SEZAM History Delete Utility A SDEL PA SEZAM Parmlist Delete Utility A SDEL SA SEZAM Saved Jobs Delete Utility A SDEL TR SEZAM Table D
38. Enter Trice n Pin a Sie SP j gt Ser Pal i B Help Exit Figure 8 13 Get Saved Job Confirmation Screen 94 SEZAM Administration Manual Copy Saved Job To copy the contents of the saved job together with its restrictions if any from one saved job to another execute the followings Enter CO COPY JOB as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job The CO direct command can also be issued on the Browse Saved Job Screen Fig 8 6 or on the Modify Saved Job Screen Fig 8 9 Enter the source and target job names Fig 8 14 Parameter Description SOURCE JOB NAME Name of the saved job to be copied TARGET JOB NAME Name of the saved job where the saved job must be copied After successfully processing the new job appears in the list of all saved jobs Fig 8 1 and the following message is displayed SEZ0230 Job copied successfully TEA OO ste OR e aa Saved ebs malena Coay Jaa 2003 08 12 Command gt Enter saved job to be copied source Job name gt SYSMAIN Enter target saved job Job name gt SYSMAIN 2 R pi E Qin aim SPP Sit Ot J Sis Bj la ee Oe l Ser Help Exit Figure 8 14 Copy Saved Job Screen 95 SEZAM Administration Manual Rename Saved Job To change the name of the saved job execute the followings Enter RE RENAME JOB
39. Generate report command 122 APPENDIX A Examples of Environment Definition BS2000 OSD GRS records for ADABAS JCL stream Prty T 2 3 4 5 10 11 12 20 21 22 23 24 25 26 27 28 31 32 35 36 38 60 64 65 66 67 68 70 EL 72 73 74 75 78 80 99 SEZENV SYSFILE A DLIB A SERFB DDASSOR1 DDATAR1 DWORKR1 SERTB DSORTR1 DTEMPR1 SERTE SERPB DPLOGR1 DPLOGR2 USERPE USERCB USERCE USERRB USERRE USERDB USERDE USERFE USERDD DDDRUCK DDPRINT EX ADARUN ADARUN PA vOGGUOGOOGAAGU USERSB ADARUN PLG USERSE USERR2B ADARUN RAI USERR2E EOF USERPA LOGOFF SEZAM Administration Manual JOBNAME LOGON REMARK COMMENTS REMARK SEZENV BS2000 1 ASSIGN SYSDTA SYSCMD ASSIGN SYSLST LI JOBNAME DB069 SRZ E E E E E E E E L Hr m mi ti m mi FILE FILE EXEC ADARU ADARU ADARU ADARU ADARU ADARU ADARU EOF SRZ SRZ SRZ SRZ SRZ SRZ SRZ ADA621 MOD ADA69 ADA69 ADA69 ADA69 ADA69 ADA69 ADA69 ASSO DATA WORK SORT TEMP PLOG1 PLOG2 L N N N N D UU O O LI JOBNAME DB069 PROG DRUCK LI JOBNAME DB069 PROG PRINT ADARUN RZ ADA621 MOD PROG PROG IDTNAME ADABAGK1 DEVICE 2000 MODE MODE DBID 069 PLOGRO NO UEX2 ADAEX2 ASS SYSOUT PRIMARY ASS SYSLST PRIMARY LOGOFF PROG SYSLST DLIB DASSOR1 SHARUPD YES DDA
40. Helja Environment gt DB002 Section gt GRS Record name gt JCH A Record prta gt 1 Record prti gt Enter the record value JOBNAME JOB USERINFO CLASS A MSGCLASS X REGION 3M NOTIFY amp SYSUID COMMENTS 50 10 gt 54 UDS Sah i OA e gt gt 00 Seda O O ee 0 Meel Jar SP Mla Pin Sit Je 118 11 0201 Pir 12 Help Exit Figure 5 11 Edit Record Screen 42 SEZAM Administration Manual Rename Record To change the name of the record and or the priorities in the ADABAS NATURAL job streams do the following Enter RE RENAME RECORD as direct command in the Command field on the screen with all records Fig 5 4 or as line command in the Co field against the appropriate record If the command was entered as direct command enter the name of the record being renamed Fig 5 9 Enter the new parameters of the record Fig 5 12 Parameter Description Required Optional RECORD NAME New record name Optional if not entered USER NAME is equal to the old name RECORD PRTA New priority in ADABAS JCL Optional if not entered stream is reset to zero RECORD PRTN New priority in NATURAL JCL Optional if not entered stream is reset to zero After successfully processing the new record appears in the list of the records Fig 5 8 instead of the old one and the following message is displayed SEZ0052 Record renamed successfully e
41. M Administration Manual 14501828 3 3 Cross referente user User dist ra 2008 5 ASIS Command gt SCROLL gt PAGE CM Command help Environment gt F177 File gt Gon Usar User Env File Date o ocho name type Tisi creation by AXBE A 20011212 KSM BEKU A AOS MI ENE M 1209207 20020702 KSM 2 DNE A 20011212 KSM __ ROZ M ET 20020702 KSM iela A 19990506 KSM SS M F177 20020702 KSM _ JNM A 19990413 KSM OM A 19991201 KSM SM A 19990413 KSM Total records gt 10 Enter PET e PRZ oH SPO SP H PE SP IO A PERLI mA PE a Help Exit Refr Figure 10 4 Environment Cross Reference List Screen 116 SEZAM Administration Manual 11 SEZAM Utilities SEZAM utilities are the part of the SEZAM Administration Subsystem Fig 1 1 and are used for the maintenance of the SEZAM objects in batch The following objects can be processed with SEZAM utilities Users Environments History Records Parameter Lists Saved Jobs Translation Tables The SEZAM Utilities Manual describes the various SEZAM utilities These are Utility Function SEZUNLD Unloading of SEZAM objects from the SEZAM system file SEZLOAD Loading of SEZAM objects to the SEZAM system file SEZDEL Delete of SEZAM objects from the SEZAM system file SEZLIST Display a range of SEZAM objects within the SEZAM system file An overview of SEZAM Utilities is shown in Fig 1 4 To invoke the SEZAM utilities enter on the
42. M Administration Manual Copy Environment To copy all the records from one environment source to another target perform the following Enter CO COPY ENVIRONMENT as direct command in the Command field on the environment list screen Fig 5 1 or as line command in the Co field against the appropriate environment Enter parameters of the source and target environments Fig 5 14 Parameter Description Required Optional SOURCE Name of environment which Required ENVIRONMENT records are to be copied SOURCE Name of section in source Optional SECTION environment all records of which are to be copied GRS records from GRS SRS records from SRS ALL records from GRS and SRS blank sections are not copied RULE Y applies the existing in the Required source environment job name rule to the target environment DESCRIPTION Y applies the existing in the Required source environment description to the target environment TARGET Name of environment to which Required ENVIRONMENT records have to be copied After successfully processing the target environment appears in the list of environments Fig 5 1 and the following message is displayed SEZ0075 Environment copied successfully 45 SEZAM Administration Manual A sess ees Environment maintenance Copy environment AOS 05 Ibi Command gt 2 ela Enter source environment section to be copied Environment gt DB001 Secti
43. M Administration screens Key Function PF1 Help PF3 Exit to previous screen Other keys appear on some screens Available PF keys and their functions are listed at the bottom of each SEZAM screen The extended information about PF keys assignments is provided on the functional screens with the CM Command Help Command Fig 3 7 Getting Help SEZAM Administration provides the possibility of getting help on every screen When entered PFI can also be used SEZAM displays a brief information describing the screen This on line help gives information about the individual functions on line help is the very best choice when questions occur while operating SEZAM 24 SEZAM Administration Manual 4 User Maintenance The user maintenance is the facility which provides definition modification browse copy and delete of SEZAM users To invoke the SEZAM user maintenance enter on the SEZAM Maintenance menu Fig 3 3 in the Function field the corresponding number of the User maintenance function 1 User maintenance All user maintenance functions can be processed from the screen with the list of all SEZAM users which is shown in Figure 4 1 13393538 gt User maintenance 7 User st gt 2003 0841 Command SCROLL gt PAGE II Vv CM Command help Co User User User Env Env File Date of name type auth name Seems Jste creation _ JNM A N 959 0413 WRI 12 N
44. OG is missing 2 EO Statement MODE MODE is missing 3 Error Break point USERDD is missing 4 Error Break point USERPA is missing 5 Warning Break point USERNB is missing 6 Warning Break point USERNE is missing 9 ETTOL More than one different DBID Total records gt II Enter PEL PRL PES im PES aA PRO a PE e 1 2 Help Exit Figure 5 16 Environment Verification Screen Error Protocol 47 SEZAM Administration Manual Delete Environment To delete the environment definition and all records associated with it take the following steps Enter DE DELETE ENVIRONMENT as direct command in the Command field on the environment list screen Fig 5 1 or as line command in the Co field against the appropriate environment If the command was entered as direct command enter the name of environment being deleted Fig 5 15 Enter the name of environment Fig 5 17 together with the section GRS SRS ALL and job name rule being deleted Confirm the delete on the confirmation screen After successfully processing the deleted environment disappears from the list of all environments Fig 5 1 and one of the following messages is displayed SEZ0029 Environment deleted successfully SEZ0218 Environment and all it s components deleted successfully 19233848 Environment maintenance Delete environment 2003 08 11 Command gt Enter environment to be deleted Environment gt D
45. OWED NOT NOT NOT ALLOWED ALLOWED ALLOWED FUNCTION FUNCTION FUNCTION FUNCTION ALLOWED ALLOWED NOT NOT ALLOWED ALLOWED FUNCTION FUNCTION FUNCTION FUNCTION ALLOWED ALLOWED ALLOWED NOT ALLOWED P FUNCTION FUNCTION FUNCTION FUNCTION ALLOWED ALLOWED ALLOWED ALLOWED Figure 2 7 Relationship between thresholds and user types The current function and command threshold settings can be viewed by SEZAM Retrieval functions see section Retrieval Functions 18 SEZAM Administration Manual 3 How to Process Administration SEZAM administration contains menus of the functions available on the level of the user type ADMINISTRATOR To invoke the SEZAM administration subsystem enter on the Administrator start up menu in the Function field the corresponding number of the SEZAM Administration function The example of start up menu is shown in Figure 3 1 When SEZAM Administration menu appears Fig 3 2 select the desired component of the SEZAM Administration Fig 1 1 by entering the appropriate function code Processing of SEZAM maintenance and retrieval functions should be done from the corresponding menus Fig 3 3 3 4 SEZAM Administration issues a message confirming each completed function If an error occurs a message appears describing the error Before doing any error analysis try reviewing the help information or PF1 for the last step you performed to see if any requirements were overlooked then r
46. RUN DBID 241 115 ADARUN SVC 45 passers A a O70 ateena 5 PE 9 91 001 12 Help Exit Restrict SE Figure 8 6 Browse Saved Job Screen SEZAM Administration Manual LASS Si Saved jobs maintenance Browse restrictions 2003 08 17 Command gt 2 Hela Job name gt SYSMAIN Job description gt COPY PROGRAMS MUB22 TO MUB22 Restriction values Date Time E gt EXCOPL IN From gt From gt 08 00 To gt To gt 09 00 Exclusive gt User list gt BRB PP s SE A Enter BS a IS O PEIO E gt Help Exit Figure 8 7 Browse Restrictions Screen 86 SEZAM Administration Manual Display System Information To browse the system information of the saved job execute the next steps Enter SY DISPLAY SYSTEM INFORMATION as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job The SY direct command can also be issued on the Browse Saved Job Screen Fig 8 6 or on the Modify Saved Job Screen Fig 8 9 If the command was entered as direct command enter the name of the job system information of which have to be browsed Fig 8 5 The following system information will be displayed Fig 8 8 Information Description Job Name of saved job Description Description of the current saved job Owner Job s owner s name Status Curre
47. Record record s name the next names are reserved break points and and must be included in GRS USERFB E the section which is to be excluded by the ormatting of the new datasets he place where the utility s datasets is to be ubstituted for example DDOUT1 he place where the utility s parameters is to be ubstituted DDKARTE USERDD Ci s s USERNB E the section which is to be excluded by the Natural b o o USERPA atch execution with user specific parameters he section which is to be included by the executing f utilities which require SORT TEMP datasets he section which is to be included by the executing nly in SINGLE mode USERPB E the section which is to be included by the executing of utilities which require PLOGR1 PLOGR2 datasets Enter PEI PE PES PPA PFS PEO PPI PEB A PRI PEIO PRII PEIS Exit Next USERTB B USERSB E Entering Commands SEZAM commands can be entered on the menus or on the functional screens To receive the information about the commands available on the corresponding screen use the following commands CD available direct commands CM available commands on the functional screens Fig 3 7 13546818 Environment maintenance Commands 2003 0111 Direct commands BR CR DE ED RE browse create edit rename record se scan and replace all records CD available global direct command s list VE verify datab
48. Restriction gt R MMe Sie Pi 2 ja a O SS OHSS JO PIT LO e Sig Hel Exit Restrict Figure 8 2 Create Job Screen 82 SEZAM Administration Manual 13856243 Saved jobs maintenance Enter restrictions AMOS US Command gt 2 ela Job name gt DAEF 00009 ASAV Job description gt DAEF 00009 ADASAV Enter restriction values Date Time SCI gt AS _ From gt From gt 08 00 To TO gt 09 00 Exclusive gt Y Browse gt _ User list gt Dice it 4120519 13 7 P gt e 141 192 Help Exit Accept Figure 8 3 Enter Restrictions Screen ESP a Tracte TUN eose hell 2003 08 12 Command gt Environment F177 Program ADASAV SAVE The job processed successfully and saved job will be created Please confirm creating with Y gt Y Enter PPI PE salen Gels Gg a 119 e 11 0231 2 2 Help Exit Figure 8 4 Create Job Confirmation Screen 83 SEZAM Administration Manual Browse Saved Job To browse the saved job perform the following steps Enter BR BROWSE JOB as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job If the command was entered as direct command enter the name of the job which contents have to be browsed Fig 8 5 The contents of the saved job to
49. SERR2E USERPA JCT SEZAM Administration Manual JOB JNM JOBNAME CLASS 0 DISP D LST CLASS A DISP D DEST USERINFO JOB JOBNAME USERINFO COMMENTS OPTION LOG SEZENV VSE EXEC PROC ADAFIL LIBDEF PHASE SEARCH SAGLIB ADA713 ASSGN SYS009 SYSLST EXEC PGM ADARUN SIZE ADARUN ADARUN PROG PROG ADARUN MODE MODE ADARUN SVC 47 ADARUN DEVICE 3390 ADARUN DBID 241 ADARUN PLOGRO NO ADARUN UEX2 ADAEX2 amp EOJ GRS records for NATURAL JCL stream 132 Prty 61 75 80 99 Record SEZENV ADAFILE1 LIBDEF N USERDD EX NATURAL USERNB NATPARM USERNE USERN2B INPL USERN2E ADARUN P ADARUN P USERPA JCT JOB JNM JOBNAME CLASS 4 DISP D LST CLASS A DISP D DEST USERINFO JOB JOBNAME USERINFO COMMENTS SEZENV VSE EXEC PROC ADAFIL LIBDEF SEARCH SAGLIB ADA713 SAGLIB USR315 TEMP ASSGN SYS000 READER EXEC PGM NAT315BA SIZE NAT315BA PARM SYSRDR AUTO OFF IM D MT 0 INTENS 1 DBID 241 STACK INPL AUTO OFF IM D MT 0 INTENS 1 DBID 241 ADARUN PROG PROG ADARUN MODE MODE ADARUN SVC 47 ADARUN DEVICE 3390 ADARUN DBID 241 amp EOJ SEZAM Administration Manual APPENDIX B PROGNAME Values
50. SEZAM ADMINISTRATION MANUAL SEZAM SEZAM Administration Manual Manual Order Number SEZ312 00A 312E 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 k soummC gmail com 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 SEZAM Administration Manual TABLE OF CONTENTS VS SUMMALY AAA AAA R 6 2 ELAM Basic Principles seeda A eap ka aida 9 ICU Generation Process A Aia 9 Break Points ts liaakia aaa 12 System Variables aaasta ausa E katalaani lad 14 Environment System Variables eeveeeneeveeenene nene nene sen esenenae nene se neneee 14 Date and Time System Variables eeeveoveeoeese
51. SEZAM Administration menu Fig 3 2 in the Function field the corresponding number of the Utilities function 3 Utilities Any of SEZAM utilities can be selected for further execution from SEZAM Utilities menu Fig 11 1 117 SEZAM Administration Manual 18301201 SEA tica ties ZOOS USES Function gt _ 1 SEZUNLD unload SEZAM objects _ 2 SEZLOAD load SEZAM objects MESES E ADEN delete SEZAM objects _ 4 SEZLIST list SEZAM objects Enter PEI PFZ PES PES PEO PE A PEB PRI PEIO PERII PEI Help Exit Figure 11 1 SEZAM Utilities menu ARAE Ua o A eie ie a a E Unilozcl SEZAM COS SEZUNLD cc 2003 08 T3 Function gt 1 Users Environments History records Parameter s list Saved job Translation tables RUR ONE mare Drei SP SSS iT St SS 2 Bj la ei il Help Exit Figure 11 2 SEZULD menu 118 SEZAM Administration Manual The following program function PF keys can be available on SEZAM Utility functional screens Key Function PF1 Help PF3 Exit to previous screen PF4 Set default values of SEZAM Utility parameters PF12 Allocate reguired datasets for the SEZAM Utility To execute any of SEZAM Utilities perform the following steps Select the SEZAM Utility by entering the corresponding number in the Function field or using the cursor on the SEZAM Utilities menu Fig 11 1
52. TAR1 SHARUPD YES DWORKR1 SHARUPD YES I DSORTR1 SHARUPD YES DTEMPR1 SHARUPD YES DPLOGR1 SHARUPD YES DPLOGR2 SHARUPD YES LINK DDDRUCK LINK DDPRINT 123 SEZAM Administration Manual GRS records for NATURAL JCL stream syntax 1 Prty Record Value 1 LOGON N JOBNAME LOGON REMARK COMMENTS 2 SEZENV REMARK SEZENV BS2000 1 3 SYSFILE N DEL FILE LI USERNAME PROG SYSOUT NAT069 DEL FILE LI USERNAME PROG SYSLST NAT069 SET JOB STEP ASS SYSOUT LI USERNAME PROG SYSOUT NAT069 ASS SYSLST LI USERNAME PROG SYSLST NAT069 4 DDLIB N FILE RZ ADA621 MOD LINK DDLIB 10 DDASSOR1 FILE RZ ADA69 ASSO LINK DDASSOR1 SHARUPD YES 11 DDDATAR1 FILE RZ ADA69 DATA LINK DDDATAR1 SHARUPD YES 12 DDWORKR1 FILE SRZ ADA69 WOR LINK DDWORKR1 SHARUPD YES 20 USERDD 2T PROC EDT B SET FILE LINK DDLNKPAR DDLNKPAR MOD J SW ON 4 5 ASS SYSDTA SYSCMD START PROG EDT 22 ADARUN PN SCR 1 ADALNK IDTNAME ADABAGK1 SCR 2 ADALNK DBID 069 23 PROC EDT E SW DDLNKPAR O SH MOD J SW OFF 4 5 SET JOB STEP ASS SYSDTA PRIMARY 24 MOD J SW MOD J SW ON 2 25 EX NATURAL START PROG DEMO NATPHSE 26 USERNB 27 NATPARM IM D AUTO OFF DBID 069 INTENS 1 LFILE 133 69 3 PS 250 LS 069 28 USERNE 29 USERN2B 30 INPL STACK INPL IM D AUTO OFF DBID 069 INTENS 1 31 USERN2E 32 EOF EOF 80 USERPA 99 LOGOFF ASS SYSOUT PRIMARY ASS SYSLST PRIMARY LOGOFF 124 SEZAM Administratio
53. THEN DO IF I 1 THEN EXECIO 1 DISKW JOBNAME DDKARTE T1 0 F 80 FINIS STRING LSE EXECIO 1 DISKW JOBNAME DDKARTE T1 FINIS STRING AKAR I ca END END KARTE DSN JOBNAME DDKARTE MODE T DATADEF DDKARTE KARTE ADARUN RESTORE ENVIRONMENT NUCXDROP ADDRESS CMS VMLINK DIR ADADIR POP DETACH ADDRESS CMS VMLINK DIR ADADIRDB POP DETACH ADDRESS CMS RELDD DO I 200 TO 225 VAR DIAG 8 CP DETACH 0 I END CP SET IMSG ON CP SET EMSG ON END GENERATION AKAR I 129 SEZAM Administration Manual GRS records for NATURAL REXX stream Prty Record 130 1 2 30 3d 49 50 52 53 54 63 64 65 69 70 72 73 74 78 JCH N SEZENV USEROS CMSSET SET NAT1 SET NAT2 ADALINK ADALINK2 DDASSOR1 DDDATAR1 USERDD CMPRINT REM001 ADARUN P ADARUN DB DDCARD WR1 DDCARD WR2 DDCARD REM003 USERPA CMSYNI WR1 CMSYNI WR2 CMSYNIN REM004 COMMENTS SEZENV VM SAY COMMENTS VM TRACE OFF SET CMSTYPE HT CP SET IMSG OFF CP SET EMSG OFF COMMON SETTINGS SET FILEPOOL DAEXUSR NATDIR DB33333A NAT314 LOAD NATDIRDB DB33333A NAT314 DBA DB33333 ADDRESS CMS VMLINK DIR NATDIRDB ADDRESS CMS VMLINK DIR NATDIR SET STORECLR ENDCMD SET LDRTBLS 20 SET LOADAREA 20000 SETTXTLB NUCXDROP NUCXTNTS RELDD FILEDEF CLEAR LINK DATABASE DO I 200 TO 225
54. TRING FINIS STRING PUSH NOTYPE PUSH NOTYPE ARUN I FINIS STRING ASYN I ARUN I ASYN I 79 80 81 84 85 86 88 89 94 95 96 99 NATPRM WR1 USERNB NATPARM USERNE USERN2B INPL USERN2E NATPRM WR2 EX NATURAL REST NAT1 REST NAT2 JCT SEZAM Administration Manual 11 APRM I Jp hd APRMSI POP DETACH NATPRM APRM NDEF APRM 1 INTENS 1 APRM 2 MT 0 APRM 3 IM D APRM 4 AUTO OFF APRM 5 WORK 1 2 AM STD APRM 1 STACK INPL APRM 2 INTENS 1 APRM 3 MT 0 APRM 4 IM D APRM 5 AUTO OFF APRM 6 WORK 1 AM STD DO I 1 TO 99 IF APRM I lt gt NDEF THEN DO IF I 1 THEN NATPRM NATPRM IF I gt 1 THEN NATPRM NATPRM END END NAT31 BATCH NATPRM RESTORE ENVIRONMENT NUCXDROP ADDRESS CMS VMLINK DIR NATDIR POP DETACH ADDRESS CMS VMLINK DIR NATDIRDB ADDRESS CMS RELDD ADDRESS CMS FILEDEF CLEAR DO I 200 TO 225 VAR DIAG 8 CP DETACH 0 I END CP SET IMSG ON CP SET EMSG ON END GENERATION 131 zIVSE GRS records for ADABAS JCL stream Prty 1 OauoePeNON NY HOOUONOOULSKRPO LJOUASRN A o 61 68 69 70 UL 72 73 75 80 99 Record SEZENV USERFB ADAFILE1 LIBDEF A USERTB USERTE USERPB USERPE USERCB USERCE USERRB USERRE USERDB USERDE USERFE USERDD ADARUN ADARUN P ADARUN P USERSB ADARUN PLG USERSE USERR2B ADARUN RAI U
55. UPDATE ENVIRONMENT as direct command in the Ccommand field on the environment list screen Fig 5 1 or as line command in the Co field against the appropriate environment Enter parameters of the source and target environments Fig 5 19 Parameter Description Required Optional SECTION Name of section records of Optional which are to be processed GRS records from GRS SRS records from SRS ALL records from GRS and SRS blank sections are not copied DESCRIPTION Y includes the environment Required description records into processing USEREXIT Y includes the job name s rule Required user exit programs into processing LIST RECORDS Y creates the list of the scanned Required replaced records RECORD LENGTH Maximum record length canbe Required reached after replace is completed UPPERCASE Y converts the replace value for Required environment s description into upper case After successfully processing the target environment appears in the list of environments Fig 5 1 and one of the following message is displayed SEZ0313 Environment searched 1 record s found SEZ0312 Environment changed successfully 1 record s replaced 50 SEZAM Administration Manual 2008 01 28 Please confirm modification of the environment DB001 gt Enter the environment s values Section ALL Description N Userexit N List records N Record length 70 Upper case Y Scan v
56. X execution or generation For more information about the usage of dynamic substituted statements please refer to SEZAM Users Manual Appendix A contains the examples of the break points and system variables in a different operating system syntax 14 SEZAM Administration Manual Date and Time System Variables SEZAM date and time system variables contain information about the current date and time They may be referenced at any point within an environment or JCL REXX Variable Date Format DATJ YYDDD Julian date DAT4J YYYYDDD Julian date DATN YYYYMMDD DATI YYMMDD DATE DDMMYY TIMN7 HHMMSST TIMN6 HHMMSS TIMN4 HHMM TIMN2 HH 15 SEZAM Administration Manual Access Control SEZAM has a comprehensive system for control the access to ADABAS database resources and to the various SEZAM functions SEZAM enables protection mechanism against an unauthorised access and improper use of the ADABAS databases in terms of environments It is possible to define exactly who is allowed to do what by restricting the use of environments ADABAS files and SEZAM functions i e ADABAS utilities NATURAL utilities NATURAL system commands etc This is accomplished by defining the objects and the relations between them There are the following main object types within SEZAM ds USERS UTILITIES SYSTEM COMMANDS etc ENVIRONMENTS ADABAS FILES The relationship between these objects is shown in Figure 2 5
57. ZAM Administration Manual Delete Parameter s Lists By Name This command is used to delete all owner s parameter s lists with the given name To perform delete execute the following Enter DE DELETE PARMLIST as line command in the Co field against the selected parameter s list s name Fig 7 2 Confirm delete of the parameter s lists with parameter s list s name Fig 7 7 After successfully processing the removed entry disappears from the list shown in Fig 7 2 and the following message is displayed SEZ0123 Parameter list s deleted successfully 17308324 Parameter s list maintenance Delete 2003 08 17 Command gt 2 Hela Please confirm delete of the 2 parameter s lists of user KSM with the name A gt aire 21 902 27 5 a Si PEII PEI Help Exit Figure 7 7 Delete Parameter s Lists By Name Screen 77 SEZAM Administration Manual Rename Parameter s Lists By Name This command is used to rename all owner s parameter s lists with the given name or with the names starting with the given name prefix to the different name To perform rename execute the following Enter RE RENAME PARMLIST as line command in the Co field against the selected parameter s list s name Fig 7 2 Enter source and target parameter s list names Fig 7 8 Enter operation mode Fig 7 8 STD standard mode Parameter s lists with the
58. aaage Recor Tigi 20 Command gt SCROLL CM Command help Co Env CM User Extended Files Jcl Date Information UNDF SYSTEM EN GRS KSM ED F13000 EX NATURAL No 2003 08 SYSTEM EN GRS KSM ED F 13000 NATPARM No 2003 08 SYSTEM EN GRS KSM ED F13000 NATPARM No 2003 08 ESO 00 SU SM ADARUN PROG USER Yes 2003 08 TO SYSTEM EN GRS KSM ED F13000 INPL No 2003 08 SYSTEM EN GRS KSM ED F13000 INPL No 2003 08 F13000 SU SM ADARUN PROG USER Yes 2003 08 1513000 SU SM ADARUN PROG USER Yes 2003 08 12130000 EX SM ADASAV SAVE FILES 812 Yes 2003 08 213000 EX SM ADASAV RESTORE FMOVE 812 Yes 2003 08 Search limit gt 0 Total records gt 10 Starting from gt 2 Record type gt Al Ending at gt 2 Enter PET 9 oS SSP Se a Pt Se Help Exit Refr JclF Figure 6 3 Record List Screen To be able to seek in the JCL REXX lines of code use the PF5 function key on the Record List Screen Fig 6 3 65 SEZAM Administration Manual Delete Records To delete the history records for a given time period perform the following steps Enter D DELETE RECORDS on the history maintenance screen Fig 6 2 Function gt D Specify type of the history records being deleted Fig 6 2 Record type gt A S system records U user records A all records Enter on the history ma
59. alue gt SVC Replace value gt Enter PEI PEL PES SS O PELO PERII PEL Help Exit Figure 5 19 Scan Environment Screen 51 SEZAM Administration Manual Job Name Rule Processing The job name rule is the site specific rule in accordance with which the name of the generated executed job is dynamically created and substituted in the system variable FJOBNAME see Appendix A Each rule consists of 52 Up to 10 source fields together with relative byte positions Start End Each source field can accept predefined or free entered value The following predefined SEZAM system variable can be used ENVIRONMENT name ofthe database environment USERNAME name of the user PROGNAME name of the current executed ADABAS NATURAL program Appendix B shows all possible values of the PROGNAME system variable Any number of PROGNAME exceptions from the rule The sense of the exceptions could be explained on the following example o The name of the job has to be generated as USERNAME Last three letters of the executed ADABAS utility For example IVULD VNSAV KSMORD etc USERNAME NAT for all the NATURAL programs For example IVNAT VNSAV KSMNAT etc Defined rule includes two pre defined fields USERNAME and PROGNAME a Source field Start End gt USERNAME 1 5 HPROGNAME____ 4_ 6 FDO OS AD 1 O 4 SEZAM Administr
60. anual 13859854 ss esseer User maintenance Create User 7 5 2005 09 11 Command gt 2 Hella Enter Wise e be Created User name gt USR001 Environment DB001 User info USR001 DB001 USR001 User type P lt A M E P gt aye 4275 in Sea l a a A Help Exit Figure 4 2 Create User Screen 14203235 Create expert person Enter file list ANOS US MIL Command gt Enter the file list for the following user User name gt USROO1 Environment gt DB001 File list 1 3 13 17 Enter Sey PE Pia PEO PEJ nn Ler 1129 Help Exit Figure 4 3 Create Expert Person Screen SEZAM Administration Manual Browse User To view the user definition perform the following steps Enter BR BROWSE USER as direct command in the Command field on the user list screen Fig 4 1 or as line command in the Co field against the appropriate user If the command was entered as direct command enter parameters of the user who has to be browsed Fig 4 4 Parameter Description Required Optional USER NAME Name of user to be browsed Required ENVIRONMENT Name of environment where Required for types M E P user is defined Don t enter for type A The user definition is represented in Figure 4 5 After successfully processing the following message is displayed SEZ0014 User browsed successfully 1420783
61. ase confirm modification of the 12 parameter s lists with the name KSM1 gt KSM1 Enter the parameter s list values Scan value gt F177 Replace value gt Q177 ico PIP LSB iT se salm PED Pi 11 lina lei 2 Help Exit Figure 7 5 Mass Update Parameter s Lists Screen 75 SEZAM Administration Manual Copy Parameter s Lists By Name This command is used to copy the owner s parameter s lists with the given name to the other user The owner of the parameter s lists and the target user must be defined with the following user s types Owner Target user v m z gt td z To perform copy execute the following Enter CO COPY PARMLIST as line command in the Co field against the selected parameter s list s name Fig 7 2 Enter source and target parameter s list names and specify the target user name Fig 7 6 After successfully processing the following message is displayed SEZ0299 Parameter list s copied successfully 17308221 Parameter s list maintenance Rename AOS 12 Command gt Enter source parameter s list to be copied User name gt KSM Parmlist name gt A Enter target parameter s list User name gt KSM1____ Parmlist name gt nMmc e PP SB Bins SSP 5 90 or 10 21 A 1123 Help Exit Figure 7 6 Copy Parameter s Lists By Name Screen 76 SE
62. ase environment SRS Sample Record Section processing Line commands BR ED DE RE browse edit delete rename record Filter functions Record show records starting with specified record s name Pa Pn show records starting with specified pa pn PRESS Avi E E i PF4 refresh is recommended after filter processing PF7 PF8 scroll forwards backwards PF10 PF11 PF12 show the list sorted by record SrtR prta SrtA prtn SrtN TS IS O BHOS JS O BIS Figure 3 8 Available Commands Screen CM command 23 SEZAM Administration Manual Once you are familiar with the SEZAM Administration and know how to find your way from menu to menu from function to function you may also be interested in a faster and more flexible way of handling SEZAM instead of having to fastidiously walk from one menu to another you may also jump directly to the function you want This is done by using of direct commands You may enter a direct command on every SEZAM Administration screen which provides a command or function line Function gt If you enter a direct command which is invalid you will receive an error message For the list of all available direct commands enter CD SHOW DIRECT COMMAND S LIST in the command line The direct commands equivalent to each function together with threshold settings are shown in the Appendix C Program Function Keys The following program function PF keys appear on all SEZA
63. ation Manual In accordance with the defined rule and depending on the executed program see Appendix B the following job names will be generated USERNAME PROGNAME _ EXCEPTION t JOBNAME KSM ADAULD no KSMULD KSM SELECT no KSMECT KSM NATLOAD no KSMLOA The first result KSMULD is correct but the last two jobs are wrong The solution to this problem is to use at the moment of the job name s generation and substitution not the original but the exceptional value of the PROGNAME variable o Define the exceptions as following A ty function Exception gt ADAVAL SELECT ADASEL NATUNLD XXXNAT NATLOAD XXXNAT ERRULDUS XXXNAT ERRLODUS XXXNAT SYSMAIN XXXNAT SCAN XXXNAT CATALL XXXNAT ADARUN PROG USER XXXNAT d In accordance with the defined exceptions and depending on the executed program see Appendix B the job names are now generated properly o USERNAME PROGNAME _ EXCEPTION t JOBNAME KSM ADAULD no KSMULD KSM SELECT ADASEL KSMSEL KSM NATLOAD XXXNAT KSMNAT 53 SEZAM Administration Manual m The user exit program which can be used alone or in combination with standard rule definition The user exit program must be coded as a Natural sub program with the following parameters 01 RESPONSE CODE P002 Response code 0 output contains user name which is used in jobname el rule ins
64. cnoonnnocnnnncccnncncnnccnnccconccccnccnonenos 74 Modify Parameter s Lists By User cccsssscesessscceessensccssssesecseseseesessnsenes 75 Copy Parameter s Lists By Name cccsecesseceeceecceecteceesceeeceecetseeseneecees 76 Delete Parameter s Lists By Name xssevsssasaciasoiasessdcesde ad odiar vk 77 Rename Parameter s Lists By Name cooccconccncncononcnnoncnnoncnonoconoccnnnccconccconcnos 78 Saved Job Maintenance drid 79 Create Saved A O O alia Ou 81 Browse Saved JOD ai a Rt 84 Display System Information ssesssccescesssssccecceeeseseseeceeccsessessaeceeeesenes 87 Modify Saved Job Inplace sn lacas 89 Put Saved Tobi 91 Get Saved JOD missinavsainsisiknta di Sen cowapaand AERE eiTe E k lani kipume a 93 A O 95 Rename Saved Titi 96 Submit Saved JO ich 97 ID Jab arukal lamama ad 98 Delete Saved JOB nar ios 100 Mass Update Saved TOS a as 101 Translation Table Maintenance sii an AA il 102 Create Translation Table isa 104 Delete Translation Tables ii bi 105 Mass Update Translation Tables ii A A Ad 106 Browse Translation Table A e O o 107 SEZAM Administration Manual Modify Translation Tabla ains 108 Delete Translation Table praia 109 Copy Translation Table ais 110 19 REIS ALAS ie 111 A AN or athe 111 CO a de ea ee eo ode es a ner ios 113 E a edo ea alero ada e Lele e a o 115 PL SEZAM IES peeve tener o e a O ee kd 117 12 SEZAM Corrections aladas 121 13 SEZAM Opuohs ata o 122
65. creen Environment maintenance Rule exceptions 2003041 1 SCROLL gt PAGE Environment gt DB001 Exception 86 ADAVAL 87 SELECT ADASEL 88 NATUNLD XXXNAT 89 NATLOAD XXXNAT 90 ERRULDUS XXXNAT vil ERRLODUS XXXNAT 92 SYSMAIN XXXNAT 93 SCAN XXXNAT 94 CATALL XXXNAT 95 ADARUN PROG USER XXXNAT Total records Total exceptions eee SO I O O IS 12 Help Exit Refr Accept Figure 5 21 Rule Exceptions Screen 56 SEZAM Administration Manual Nr Source field Start End 1 USERNAME 3 2 A 1 dl 2 PROGNAME 3 6 4 5 6 Y 8 9 10 Environment maintenance 7 Test tule 7 2 2008 01 28 SCROLL gt PAGE A AR SAS A MA s DE O A E Selec test values Env gt A016 User A AS Prog gt ADACMP COMPRESS Excp gt Exit gt UEXRULO1 1 Co Utility Function Exception ADACMP COMPRESS no ___ ADACMP DECOMPRESS no ___ ADADBS ADD no ADADBS NEWALTS no __ ADADBS INCREASE no ___ ADADBS DECREASE no ___ ADADBS ALLOCATE no ER LIRA LO ERA EDD e MEE IN MERA OSI MEA AER OLE ARE i Enten PRI PRm APO Pn 425 BRO St Se PRO PETO RE 11919127 Help Exit Test Figure 5 22 Test Rule Screen 57 SEZAM Administration Manual Delete Rule To delete the job name rule take the following steps Enter DRU DELETE RULE as direct command in the Command field on the environment list screen Fig 5 1
66. e command Fig 9 2 Enter the environment name or leave it empty for the global t table Fig 9 7 After successfully processing the t table will be displayed on the screen and the following message is displayed szos T table modified successfully 10221828 Translation table maintenance Edit table 20030815 Command gt Enter owner of the table being modified User nane gt KSM Environment gt Dice Lai it SS Se Bye PN Slt J 2 jal e Leip lle 7 Help Exit Figure 9 7 Modify Translation Table 108 SEZAM Administration Manual Delete Translation Table To delete the single Translation table of the t tables owner or of the user not more defined in the SEZAM perform the following Enter DE DELETE T TABLE as direct or line command Fig 9 2 Enter user name together with the environment name or leave the environment name empty for the global t table Fig 9 8 Confirm processing with the user name and the environment name only for the local t tables After successfully processing the t table with the given name will disappear from the list shown in Fig 9 2 and the following message is displayed SEZ0410 T table deleted successfully 15 34 11 Translation table maintenance Delete single table 2003 08 13 Command gt 2 Hela Enter owner of the table being deleted User name gt KSM Environment gt reer l n 3
67. e issued on the Browse Saved Job Screen Fig 8 6 If the command was entered as direct command enter the name of the job which contents have to be modified Fig 8 5 Change the contents of the job together with job s description and disposition Fig 8 9 The following information is shown Information Description Job Name of saved job Desc Description of the current saved job Rest Restriction status of the current saved job Disp Disposition of the current saved job Total Total number of the strings in the current job To modify the restrictions press PF5 and make the following o enter restriction values of the job being created Fig 8 3 Parameter Description DATE FROM TO Date after before which the job can be submitted in the following format YYYY MM DD date blank not defined TIME FROM TO Time after before which the job can be submitted in the following format HH MM time blank not defined DATE TIME EXCEPT Sequence of date time restrictions processing Y rejects the jobs which satisfy restrictions N accepts the jobs which satisfy restrictions USER LIST Names of users up to 10 who are authorised to submit the current job blank all the users on the restrictions screen Fig 8 3 press PF6 to accept the restrictions 89 SEZAM Administration Manual After successfully processing the following message is displayed SEZ0191 Restrictions accepted successfully o press PF3 to r
68. ea Application Yes Yes Yes 2000 02 09 KSMFSLOD A018 daea Application Yes Yes Yes 2000 02 09 KSMFSLOD A019 daea Application Yes Yes Yes 2000 02 09 KSMFSLOD A020 daea Application Yes Yes Yes 2000 02 16 KS A026 daea Application Yes Yes Yes 2000 12 22 RS Total records gt 10 Enter Pin l PrI peo Pea O nel m ami 2 Help Exit Refresh Figure 5 1 Environment List Screen The value Yes in the General or Sample Record Section means that the corresponding section is not empty i e there are records in it The value Yes in the Jobname Rule field means that the rule has been defined for the corresponding environment 33 SEZAM Administration Manual Create Environment To create the environment you have to create the first record in any section of it GRS or SRS Fig 2 1 To do it take the following steps Enter CR CREATE ENVIRONMENT command in the Command field on the environment list screen Fig 5 1 Enter parameters of the environment which has to be created Fig 5 2 Parameter Description Required Optional ENVIRONMENT Name of environment which Required has to be defined SECTION NAME Name of the section GRS SRS Required where the first record has to be placed RECORD NAME Name of the first record Required being created RECORD PRTA Record priority in ADABAS Optional only for GRS JCL stream records RECORD PRTN Record priority in NATURAL Optional only for GRS JCL stream records
69. ed successfully 40 SEZAM Administration Manual O ee mi BROS EMS CO A O c ZOOS Oem 1 1 Command gt 7 elas Environment gt DB002 Section GRS mare record Lo le DOW SC Ck Record name gt JCH A aega ARREZ gt 2724120579197 Sep 2512 Help Exit Figure 5 9 Example of Enter Record Screen a Environment maintenance Browse record 2003 08 11 Command gt Environment Section Record name Record prta Record prtn Record value JOBNAME JOB USERINFO CLASS A MSGCLASS X REGION 3M NOTIFY amp SYSUID COMMENTS marce Boi a 4 27 5 7 PE J ln al 0 1217 l il 2 Help Exit Figure 5 10 Browse Record Screen 41 SEZAM Administration Manual Modify Record To change the contents of the record execute the next steps Enter ED EDIT RECORD as direct command in the Command field on the screen with all records Fig 5 4 or as line command in the Co field against the appropriate record If the command was entered as direct command enter the name of the record which contents have to be changed Fig 5 9 Change the contents of the selected record on the screen Fig 5 11 After successfully processing the following message is displayed SEZ0046 Record modified successfully 1421 8 84 Environment maintenance Edit record 2003 08 11 Command gt 2
70. elete Utility A SDEL US SEZAM User Delete Utility A SDEV SEZAM ADABAS Device Type Calculator E SEZDBID Display active databases P SEZDDM Display view control information P SEZFDT Display field description table FDT P SEZFILE Display loaded files P SFUN SEZAM Special functions P SLIB SEZA sibrary Information M SLOD SEZA oad Utility A SLOD EN SEZAM Environment Load Utility A SLOD HI SEZAM History Load Utility A SLOD PA SEZAM Parmlist Load Utility A SLOD SA SEZAM Saved Jobs Load Utility A SLOD TR SEZAM Table Load Utility A SLOD US SEZAM User Load Utility A SLST SEZA ist Utility A SLST EN SEZAM Environment List Utility A SLST HI SEZAM History List Utility A SLST PA SEZAM Parmlist List Utility A SLST SA SEZAM Saved Jobs List Utility A SLST TR SEZAM Table List Utility A SLST US SEZAM User List Utility A SMAN SEZA aintenance P SMAN EN SEZAM Environment Maintenance A 137 SEZAM Administration Manual SMAN HI SEZAM History Maintenance A SMAN PA SEZAM Parmlist Maintenance A SMAN SA SEZAM Saved Job Maintenance A SMAN TR SEZAM Translation Table Maintenance A SMAN US SEZAM User Maintenance A SOPT SEZAM Installation options P SRE SEZAM Retrieval menu A SRET CO SEZAM Command Retrieval A SRET FU SEZAM Function Retrieval A SRET XR SEZAM Cross Reference A SRET RE SEZAM Resource Utilization
71. en Fig 6 8 For more information refer to the section History Job Processing 69 SEZAM Administration Manual Job Processing To browse modify re submit or export the job stored in the history records execute the following Enter JC PROCESS JOB as line command in the Co field against the corresponding history record on the screen shown in Figure 6 3 The JCL REXX contained in the selected record is shown in Figure 6 7 To invoke the built in editor and process the job modification press the PF5 function key Successfully processing is indicated by one of the following messages SEZ0347 History JCL browsed successfully SEZ0348 History JCL browsed partially 18238804 5 3 History maintenance Browse JCL 2003 08 12 Command gt SCROLL gt PAGE CM Command help 2003 08 11 OSORIO AS Total gt 25 25 Time 0001 KSMFASAV JOB 999 KSM CLASS W MSGCLASS X 0002 SEZ312 F13000 ADASAV Save files FILE 812 0003 SEZENV F13000 0004 ROUTE XEQ DAEF 0005 JOBPARM SYSAFF DAEF 0006 ROUTE PRINT DAEF 0007 SEZADA EXEC PGM ADARUN REGION 8000K TIME 1440 0008 STEPLIB DD DSN RZDBA DB13000 NEWLOAD DISP SHR 0009 DD DSN RZDBA DB13000 LOAD DISP SHR 0010 DDASSOR1 DD DSN DB13000 ASSOR1 DISP SHR 0011 DDDATAR1 DD DSN DB13000 DATAR1 DISP SHR 0012 DDWORKR1 DD DSN DB13000 WORKR1 DISP SHR 010 020 030 040
72. er gt real file number 99999 logical file number indicates that the total number of files is more than 50 JCL Up to 300 lines of JCL REXX which was IKSMFAREP JOB involved in the corresponding event JOB LOCATION Location of the job being processed within Area KSM SJDUMMY the current event Object NATURAL object Area NATURAL source area Saved SEZAM saved area H SEZAM history record lt user gt lt Y Y Y YMMDD gt lt HH MM SS gt Exec directly executed with EX command TIME Time when the event took place in the 17 04 41 9 HH MM SS 0 format USER Name of SEZAM user who has initiated KSM the current event The information provided by the history facility allows DBA to control and regenerate the events and their sequence within SEZAM The use of history facility simplifies the database administration and makes it possible to find out who when and what has done SEZAM allows dynamically customizing of the history facility including it s activation and deactivation For more information about this service consult SEZAM Installation Manual 62 SEZAM Administration Manual To invoke the SEZAM history maintenance enter on SEZAM Maintenance menu Fig 3 3 in the Function field the corresponding number of the History records maintenance function 3 History records maintenance All history maintenance functions can be processed from the screen which is shown in Figure 6 2 DRO Oss S
73. etry the operation For information about SEZAM Messages refer to SEZAM Messages Manual Subsequent sections in this manual describe the major SEZAM Administration functions and menu screen structures in the order they appear SEZAM Utilities Manual describes the various SEZAM batch utilities 19 SEZAM Administration Manual 09380523 2 AN SS E O 7 2006 07 14 Function gt 1 SEZAM administration ADABAS maintenance ADABAS EVENT REPLICATOR maintenance NATURAL maintenance Finished objects Special functions Authorities ADU BWNHE mateeria 3 in lm im 12119 ein 10 PFEILE Help Exit Figure 3 1 Administrator Start up menu Toro O a Sua ECM EENE ON Aaa 2003 08 1 mate koja gt Maintenance Retrieval Utilities Corrections Options Uh ON Mito lt Pt ely 9 Gi 72190011 9501109 Figure 3 2 SEZAM Administration menu 20 SEZAM Administration Manual SSI e SO SEAL O HaHa a a 2003 08 11 Puno gt User Environment History records Parameter s list Saved job Translation table DD 04d YN eee 11 ai Say LOSS k a AAA AREA SS EE EEE Figure 3 3 SEZAM Maintenance menu EOS IOO a a SEAME E TES 7 ae e a 2003 08 11 acido gt A cales _ 2 Commands _ 3 Environments _ 4 Resources E A II O E Help Exit Figure 3 4 SEZAM Retrieval menu 21 SEZAM Administration Manual Screens The SEZAM Administration screen
74. eturn to the modify job screen On the modify job screen Fig 8 9 press ENTER to accept the job s modifications After successfully processing the following message is displayed SEZ0179 Job modified successfully O aaa Savec Jela medaesaee Heie Joad 2003 08 12 Command gt SCROLL gt PAGE 2 eha Job SYSMAIN Desc COPY PROGRAMS MUB22 TO MUB22 Rest N Disp D moral 29 Owner il JOB JNM NSMAE1 CLASS Z SYSID 6 DISP D 2 LST CLASS Z FNO A03U 3 JOB NSMAE1 SOK DB ADMINISTRATOR 4 SEZAM 2 0 EW1 USER SYSMAIN CO programs FromTo MUB22 MUB22 5 ASSGN SYS000 READER 6 IF EXEC PGM NAT22XBA SIZE NAT22XBA PARM SYSRDR y IM D MADIO 0 MAXCL 0 MT 0 OBJIN R AUTO OFF DC DTFORM I 8 ID USIZE 64 ESIZE 100 MCG 0FF DBID 241 9 E 10 ADARUN PROG USER 111 ADARUN MODE MULTI 12 ADARUN DBID 241 TS ADARUN SVC 45 A A SS ee A ge O OS OP PIS Help Exit Restrict aF Figure 8 9 Modify Saved Job Screen 90 SEZAM Administration Manual Put Saved Job With combination of PUT GET commands it is possible to modify the saved jobs not only in place To realise this possibility it is necessary to put the saved job from the SEZAM Saved Area into the NATURAL text object modify its contents with the NATURAL editor and get the job to the Saved Area back After putting the job into the NATURAL object the saved job remains in the locked status It is not poss
75. gether with some additional information will be shown Fig 8 6 Information Description Job Name of saved job Desc Description of the current saved job Rest Restriction status of the current saved job Disp Disposition of the current saved job Total Total number of the strings in the current job For restricted jobs press PF5 to browse through restrictions of the current saved job Fig 8 7 After successfully processing the following message is displayed SEZ0175 Job browsed successfully 84 SEZAM Administration Manual 15301509 Saved jobs maintenance Browse job 00508 2 Command gt Enter job to be browsed Job name gt SYSMAIN acer Lo 72 Pig i 1910 9 10 PETT RF 2 Help Exit Figure 8 5 Example of Enter Job Name Screen BOS Opes eo ce Saved job maintenance Browse job 2008708 12 Command gt SCROLL gt FAGE B elo Job SYSMAI Desc COPY PROGRAMS MUB22 TO MUB22 Rest R Disp D motes 29 Owner 1 JOB JNM NSMAE1 CLASS Z SYSID 6 DISP D 2 LST CLASS Q FNO A03U 3 JOB NSMAE1 SOK DB ADMINISTRATOR 4 SEZAM 1 0 EW1 USER SYSMAIN CO programs FromTo MUB22 MUB22 5 ASSGN SYS000 READER 6 EE PGM NAT22XBA SIZE NAT22XBA PARM SYSRDR 7 IM D MADIO 0 MAXCL 0 MT 0 OBJIN R AUTO OFF DC DTFORM I 8 ID USIZE 64 ESIZE 100 MCG OFF DBID 241 ETID 1 9 s 10 ADARUN PROG USER 111 ADARUN MODE MULTI 12 ADA
76. h require SORT and TEMP datasets 13 SEZAM Administration Manual System Variables Environment System Variables Some parameters of the independent part Fig 2 3 can not be premeditated because they get their values dynamically For example ADARUN MODE mode of operation which can be MULTI or SINGLE To provide this possibility SEZAM uses a concept of environment system variables which must can be defined in the environment Variable Description Required Optional COMMENTS JCL commentary is generated dynamically Optional JOBNAME Job name is defined in accordance with Optional site specific rules in environment maintenance PROG ADARUN PROGRAM parameter is generated Required dynamically MODE ADARUN MODE parameter is generated Required dynamically USERNAME User name is replaced with the NATURAL Optional system variable USER USERINFO User specific JCL information is defined Optional in user maintenance SEZAM functions can not be performed properly if the required breakpoints or the system variables are missing or invalid To check the environment definition against possible errors use the environment verification facility The usage of dynamic substituted statements increases the flexibility of the environments and reduces the storage required for the SEZAM system file This feature allows definition of one or more blocks of statements within GRS records These statements could be dynamically modified during the JCL REX
77. he following USERCB E USERDB E USERDD USERFB E USERNB E USERN2B E USEROS USERPA USERPB E USERRB E USERR2B E USERSB E USERTB E all records between USERCB and USERCE are included by the execution of utilities which require CLOGR1 CLOGR2 datasets all records between USERDB and USERDE are included by the execution of utilities which require DSIMR dataset place where the utility s datasets are to be substituted for example DDSAVEI Fig 2 4 all records between USERFB and USERFE are excluded by the formatting of the new datasets all records between USERNB and USERNE are excluded by the execution of NATURAL batch with user specific parameters all records between USERN2B and USERN2E are included by the execution of NATURAL INPL only for VM ESA the VM ESA operating system indicator must be set to VM place where the utility s parameters are to be substituted Fig 2 4 all records between USERPB and USERPE are included by the execution of utilities which require PLOGR 1 PLOGR2 datasets all records between USERRB and USERRE are included by the execution of utilities which require RLOGR1 RLOGM 1 datasets all records between USERR2B and USERR2E are included by the execution of ADARAI RECOVER all records between USERSB and USERSE are included by the execution in ADABAS SINGLE mode all records between USERTB and USERTE are included by the execution of utilities whic
78. hich will apply to most potential users Each user type has the strictly defined set of allowed SEZAM functions which organisation is represented in Figure 2 6 EXPERT MANAGER ADMINISTRATOR Figure 2 6 User s Authorities to use the SEZAM functions 17 SEZAM Administration Manual User must be defined in each environment where he is going to operate The type of the user in each environment can be different The only exception is ADMINISTRATOR who is defined only once The usage of environments and ADABAS files can be restricted for each individual user At the same point SEZAM does not permit the individual definition of the set of available utilities it can only be done pro user type It is realised on the basis of thresholds which are assigned to every SEZAM function and should be achieved or exceeded by the user when attempting to execute the utility The balance between the user type and the threshold value makes it possible to ensure the high level of protection SEZAM provides direct commands for performing the most functions Each direct command corresponds to a function on SEZAM menus and can be executed only by users with correspondent type The system reaction on the direct command depends on the balance between the user s type and the function s threshold The relationship between thresholds and user types is shown in Figure 2 7 FUNCTION FUNCTION FUNCTION FUNCTION ALL
79. his screen Fig 7 2 Command Description CO Copy parameter s lists by name DE Delete parameter s lists by name RE Rename of parameter s lists by name 72 SEZAM Administration Manual Copy Parameter s Lists By User This command is used to copy all owner s parameter s lists to the other user The owner of the parameters lists and the target user must be defined with the same user s type To perform copy execute the following Enter CO COPY PARMLIST as line command in the Co field against the selected parameter s list s name Fig 7 1 Enter source and target parameter s list owner s names and specify the Replace option Fig 7 3 After successfully processing the following message is displayed SEZ0299 Parameter list s copied successfully 16288817 Parameter s list maintenance Copy 29501122 Command gt Enter source and target parameter s list names Source parmlist name gt A001 Target parmlist name gt X001 Replace gt gt N Enter 7 PE PES Sl 101121 JSP J 217 PELOS PEIL RETS Help Exit Figure 7 3 Copy Parameter s Lists By User Screen 73 SEZAM Administration Manual Delete Parameter s List By User This command can be applied against the parameter s lists of the not existed users or of the owner s parameter s lists To delete all parameter s list of the given user execute the following Enter DE DELETE PARMLIST as li
80. ible to modify or submit the locked job Successfully processing of the GET command unlocks the saved job automatically To put the saved job into the NATURAL object execute the followings Enter PU PUT JOB as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job Enter the name of the job which have to be put into the NATURAL object together with the name of the corresponding NATURAL object Fig 8 10 Parameter Description SOURCE JOB NAME Name of the saved job TARGET JOB NAME Name of the NATURAL object where the saved job must be put Confirm processing Fig 8 11 After successfully processing the saved job will be placed in the locked status 91 SEZAM Administration Manual 14403252 25 Saved jobs maintenance Put job ANOS RS 12 Command gt Enter saved job to be put source Job name gt SADA ADASAV Enter the target job Job name gt JCL003 Mare Prle PES PES Pra 5 27 J j Sia 1 0 25111 PEIA Help Exit Figure 8 10 Put Saved Job Screen A eae al YUE JIN elgimekaaeeea SS a 2003 08 12 Command gt Environment F164 Program ADASAV SAVE The job processed successfully and job will be overwritten Please confirm putting with Y aegsel 2 SIA SS OSS JS Se BSS Pl Se OSS e B Help Exit Figure 8 11 Put Saved Job Confirmation Scree
81. ic Principles system records the records with the names starting with are the environment identification records or i records The usage of the i records together with SEZENV statement accelerates the job generation process and makes it possible to specify more than one environment with the same DBID The SEZENV parameter should be set to the environment s name The SRS records are used in accordance with JCL REXX requirements for the ADABAS NATURAL utilities for example AUSBA BACK PLOGR1 OUTI etc For example ADABAS utility UNLOAD requires the allocation of OUTI dataset To provide the possibility of default allocation the corresponding SRS record with the name OUT1 must be defined in the environment For information about dataset allocation consult SEZAM User s Manual If the priority values PRTA PRTN are not entered the corresponding GRS record does not participate in the generation process for the ADABAS NATURAL Enter the value of record Fig 5 7 After successfully processing the created record appears in the list of the records Fig 5 8 and the following message is displayed SEZ0033 Record created successfully 38 SEZAM Administration Manual Ss Sus IS 5 3 3 3 Create ecerd Biter vecord Ss e 2355 200303141 Command gt 7 Helje Environment DB002 Section GRS Enter eco Lo be created Record name Record prta Record prtn ES A SI SSP A AS II Help Ex
82. in the global table will be activated only if the local table is missing To invoke the SEZAM Translation table maintenance enter on the SEZAM Maintenance menu Fig 3 3 in the Function field the corresponding number of the Saved job maintenance function 6 Translation table The list of all defined Translation tables will be shown in the short format Fig 9 1 09243834 Translation table maintenance List short ZOOS 03115 Command gt SCROLL gt PAGE CM Command help Co User User Quantity name Status ae KSM A 2 pu KSM1 A Al T PEMA A 2 TSR A 1 Total records gt 4 are 22 it salmis SSS OS a A LO ep 1 21 Help Exit Refr EULI Figure 9 1 Translation Table List Screen Short Format 102 SEZAM Administration Manual The information shown in Figure 9 1 includes the following Information Description USER NAME Name of the table s owner USER STATUS Status of the table s owner A owner exists in SEZAM is active N owner does not exist QUANTITY Number of the tables of the owner TOTAL RECORDS Number of processed records The following commands can be processed on the screen shown in Figure 9 1 Information Description CR Create Translation table DE Delete Translation table by user SC Mass Update Translation tables by user By pressing on PF11 you can switch to the list of all defined Translation tables of the current use
83. intenance screen Fig 6 2 the time period Starting from date gt 2003 08 11 Ending at date 2003 08 12 Confirm delete of the records with DELETE ALL Fig 6 4 After successfully processing the following message is displayed SEZ0138 History records deleted successfully 66 SEZAM Administration Manual 15309229 History maintenance Delete number of records ANS US IZ Command gt 2 elos Please confirm delete of the 27 records with DELETE ALL gt DELETE ALL Dire PP Laie i SS PES han gt l ei lei 2 Help Exit Figure 6 4 Delete Number of Records Screen 67 SEZAM Administration Manual Browse Single Record To view the detailed information contained in the history record execute the following Enter BR BROWSE RECORD as line command in the Co field against the appropriate history record on the screen shown in Figure 6 3 The history information contained in the selected record is shown in Figure 6 5 After successfully processing the following message is displayed SEZ0135 History record browsed successfully 3812887 2 5 35 History maintenance Browse records 20030012 Command gt CM Command help Environment gt F13000 User gt KSM Sezam command gt EX Date gt 2003 08 11 Cil gt Yes Time gt 08 57 35 7 Extended info gt ADASAV RESTORE FMOVE Job location gt Exec Natu
84. it Figure 5 6 Create Record Enter Record Screen 63394 Create tecord1 Enter record o gt gt Z2OOS O8 il Command gt Environment Section Record name Record prta Record prtn EX ADARUN 2 Enter the record value STEPO1 EXEC PGM ADARUN ses pS e gt gt p 10 gt aa A gt gt E IS O O SEO 11 EPEL Help Exit Figure 5 7 Create Record Screen 39 SEZAM Administration Manual TG TA OF a a a a REG CGC eS Care A 2003 08 11 Command SCROLL PASE II Vv CM Command help Environment gt DB002 Section GRS COMES coa Pa Dia Value EX ADARUN 2 STEPO1 EXEC PGM ADARUN JCHA il JOBNAME JOB USERINFO CLASS A MSGCLASS X REGION 3 Total records gt 2 Magee Pri jr 3 Jar eli Li Pine Help Exit Refr SEERIAS TAAS ATENI Figure 5 8 Record List Screen after execution of Create Record command Browse Record To view the contents of the record take the next steps Enter BR BROWSE RECORD as direct command in the Command field on the screen with all records Fig 5 4 or as line command in the Co field against the appropriate record If the command was entered as direct command enter the name of the record which contents have to be browsed Fig 5 9 The contents of the record is shown in Figure 5 10 After successfully processing the following message is displayed SEZ0043 Record brows
85. lp Exit Refresh F EUI Figure 7 1 Parameter s List Screen Short Format The information shown in Figure 7 1 includes the following Information Description QUANTITY Number of parameter s lists for a current user USER NAME User name USER TYPE User s type A M E P administrator manager expert person user not exist USER STATUS Current user status A user exists in SEZAM is active N user does not exist 71 SEZAM Administration Manual The following commands can be processed from this screen Fig 7 1 Command Description CH Update parameter s lists by user DE Delete parameter s lists by user Pressing PF11 on the screen Fig 7 1 causes switch to the full format Fig 7 2 1035020 Parameter s list maintenance List names AOS US 2 Command gt SCROLL gt PAGE CM Command help User name 7 KSM Co Parmlist name Quantity ei AERXXX AERLOD AERXXX AERULD ATITM SYSFILE A001 A001 INCREASE A012 A014 A014 FUSER 2 A016 N WRRPUONPRPRPRE m Total records gt 10 Enter 21 22 1211 B SSI P i A PEIO Sea i ei i 2 Help Exit Refresh E Short Figure 7 2 Parameter s List Screen Full Format The information shown in Figure 7 1 includes the following Information Description PARMLIST NAME Parameter s list name QUANTITY Number of parameter s lists with the given name USER NAME User name The following commands can be processed from t
86. n 92 SEZAM Administration Manual Get Saved Job To get the saved job from the NATURAL text object execute the followings Enter GE GET JOB as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the corresponding locked job i e against the job previously processed with the PU PUT JOB command Enter the name of the job which have to be got from the NATURAL objects together with the name of the corresponding NATURAL object Fig 8 12 Parameter Description SOURCE JOB NAME Name of the NATURAL object from where the saved job must be got TARGET JOB NAME Name of the saved job in the locked status Confirm processing Fig 8 13 After successfully processing the saved job is be unlocked and the following message is displayed ES Job captured successfully 93 SEZAM Administration Manual 14207228 mera Saved jobs maintenance Get job ANOS RS 12 Command gt Enter job to be captured source Job name gt JCL003 Enter parameters of the saved job target Job name gt SADA ADASAV aega lar Pig j Sind ip SSP Gg Bn P Sen len era 2 Help Exit Figure 8 12 Get Saved Job Screen AS SO OS CERO RCA ey SSR SSS 2003 08 12 Command gt Environment F164 Program ADASAV SAVE The job processed successfully and saved job will be overwritten Please confirm getting with Y
87. n Manual GRS records for NATURAL JCL stream syntax 1 Prty E 10 11 12 20 21 22 23 24 25 26 27 28 29 30 31 32 33 64 65 80 99 Record SEZENV SYSFILE N DLIB N DDASSOR1 DDATAR1 DWORKR1 SERDD ROC ADA B WEaEUU U ADARUN PN PROC ADA E USERNB PROC NAT B NATPARM PROC NAT E USERNE USERN2B PROC INP B INPL PROC INP E USERN2E MOD J SW EX NATURAL USERPA LOGOFF JOBNAME LOGON RZDB 1 SKIP COMMANDS TO LABEL BEGIN COMMENTS JOB JOBNAME RUN FOR USERINFO BEGIN REMARK REMARK SEZENV BS2000 2 DEL FILE LI USERNAME PROG SYSOUT NAT2001 DEL FILE LI USERNAME PROG SYSLST NAT2001 SET JOB STEP ASS SYSOUT LI USERNAME PROG SYSOUT NAT2001 ASS SYSLST LI USERNAME PROG SYSLST NAT2001 FILE SRZDB DEMO ADA712 MOD LINK DDLIB FILE RZDB ADA2001 ASSO LINK DDASSOR1 SHARUPD YES FILE RZDB ADA2001 DATA LINK DDDATAR1 SHARUPD YES FILE RZDB ADA2001 WORK LINK DDWORKR1 SHARUPD YES SET FILE LINK DDLNKPAR DDLNKPAR MOD J SW ON 4 5 ASS SYSDTA SYSCMD START PROG EDT SCR 1 ADALNK IDTNAME ADABASSN SCR 2 ADALNK DBID 2001 SW ADDLNKPAR O SH SET JOB STEP REMOVE DYNAMIC PARAMETERS WITH EOF SET FILE LINK CMPRMIN CMPRMIN START PROG EDT SCR 1 IM D AUTO OFF DBID 2001 INTENS 1 SW CMPRMIN O SH MOD J SW OFF 4 5 SET JOB STEP ASS SYSDTA PRIMARY REMOVE DYNAMIC PARAMETERS WITH EOF
88. ne command in the Co field against the corresponding user on the parameter s list screen Fig 7 1 Confirm delete of all the parameter s lists for selected user with the user s name Fig 7 4 After successfully processing the removed entry disappears from the list shown in Fig 7 1 and the following message is displayed SEZ0123 Parameter list s deleted successfully 16252356 Parameter s list maintenance Delete ZOOS SU Command gt Please confirm delete of the 2984 parameter s lists with the name KSM gt Enter PET 9 5 0 e el ein it 7 2 Help Exit Figure 7 4 Delete Parameter s Lists By User Screen 74 SEZAM Administration Manual Modify Parameter s List By User This command is used to perform mass update scan and replace of the all parameter s lists of the given user To perform update execute the following Enter SC MASS UPDATE PARMLIST as line command in the Co field against the corresponding user on the parameter s list screen Fig 7 1 Enter the scan replace criteria and confirm mass update with owner s name Fig 7 5 After successfully processing the one of the following messages is displayed SEZ0288 Parmlist searched 1 record s found SEZ0282 Parmlist changed successfully 1 record s replaced 133159282 Parameter s list maintenance Change AVOS O8 12 Command gt 5159 Ple
89. nene nene sen esenenae nene ians 15 Access Control M a E brutes lve dens 16 3 How to Process Administration ooooccnnoooccoooonnccnnonnnonnnnnnnononnnnnnonononnos 19 SEA as 22 Entering Commands ola ika 23 Program Function Ko anu osi 24 Getun Help ea a DA e e Geis EENE AEN 24 A User Viene 25 AAE E ET EA A T NE E 25 Browse User dois 28 Modify Us road 30 C py US A ai edad Oak nde 31 DEA A Riedl RH AU aoe a 32 5 Environment Maintenance aii 33 Create Ehvirohmeit samas ias 34 Modify PAM 36 Create Record aiii ida cid A E 38 Browse Record srssivaa sav te sc dv ccsed duced viens cals snd idear ed daa de eve sada 40 Modify Record sesanti ca ogo ds aus one ee side DIR reee saade de aoid ao a AAO sa nae oo 42 Rename Record nda ion socia 43 Delete Record iii A ja le sla 44 Copy PAINE 45 Verify Environments A AA 46 Delete Ehvit hmeiti suusasammu 48 Rename Environment Ad 49 Mass Update Environment arado 50 Job Name Rule Processing iii 52 Create RUE ST TTT ST 55 Delete A aoan TTT TS 58 SEZAM Administration Manual Description Proc ini 59 Create Description cari a AS AS saree KEE 59 Delete Description aces cscescrcwicsinctinswcebcneescscanes e na TT 60 History Maintenance ci tinta 61 A 64 Delete Records at rs 66 Browse Single Recordad aora 68 Delete Single Record Aarau 69 VOD POTES a Aros 70 Parameter s List Maintenance a 71 Copy Parameters Lists BUSTA A uti 73 Delete Parameter s Lists By User ooccoooccconc
90. nistration Manual SA gm IRE COT AGA STT ae ae 2003 08 11 Command gt SCROLL gt PAGE CM Command help Environment Section CO Record Pa Pn Value JCH A dl JOBNAME JOB USERINFO CLASS A MSGCLASS X REGION 3 Total records gt 1 Mare Zin jai la PP Sa lim Oil 12 Help Exit Refr SEER STEA SreN Figure 5 4 Record List Screen 18348843 Environment maintenance Enter environment 200 T 0611 Command gt 2 els Section gt GRS Enter environment the section of which have to be processed Environment gt DB002 nee PP l Sei AA 2 Help Exit Figure 5 5 Enter Environment Screen 37 SEZAM Administration Manual Create Record To add a new record to the section execute the next steps Enter CR CREATE RECORD as direct command in the Command field on the screen with all records Fig 5 4 Enter parameters of the record which being created Fig 5 6 Parameter Description Required Optional RECORD NAME Name of the record to be Required created RECORD PRTA Record priority in the Optional for GRS ADABAS JCL stream RECORD PRTN Record priority in the Optional for GRS NATURAL JCL stream The names of the GRS records are not informative and have no influence on the JCL generation process The exceptions are break points which must have the predefined names USERDD USERPA etc For more information about break points consult SEZAM Bas
91. ns over the records which are defined in the environment The following commands can be processed Command Description BR CR Browse Create record ED RE Edit Rename record SC VE Mass update Verify environment DE Delete record GRS SRS Switch to GRS SRS section All listed above commands must be entered on the screen with the list of all records in the appropriate section GRS SRS of the corresponding environment The example of this screen 1s shown in Figure 5 4 To obtain it perform the following Specify the section GRS SRS the records of which have to be processed To do it enter on the environment list screen Fig 5 1 as direct command in the Command field or as line command in the Co field the following GRS for General Record Section SRS for Sample Record Section If the GRS SRS command was entered as direct command enter the name of the environment which contains the section being processed Fig 5 5 The following program function PF keys appear additionally on the screen Fig 5 4 Key Function Description PF4 Refresh Refresh the screen contents PF10 Sort by record name Show the screen contents in the sequence of record name PF11 Sort by priority in ADABAS Show the screen contents JCL stream in the sequence of priority in ADABAS JCL stream PA PF12 Sort by priority in NATURAL Show the screen contents JCL stream in the sequence of priority in NATURAL JCL stream PN 36 SEZAM Admi
92. nstead of USERNAME 4 output contains jobname jobname rule is not used 01 ENVIRONMENT A010 Environment name 01 USERNAME A008 User name 01 PROGNAME A030 Program name for example ADAREP SYSTRANS etc 01 OUTPUT A008 Output OCAL 01 LENGTH P002 User variables END DEFINE Put your code here MOVE USERNAME TO OUTPUT Exceptions DECIDE ON FIRST PROGNAME VALUE SELECT PROGNAME ADASEL VALUE NATUNLD PROGNAME XXNULD VALUE NATLOAD PROGNAME XXNLOD VALUE ERRULDUS PROGNAME XXNERU VALUE ERRLODUS PROGNAME XXNERL VALUE SYSMAIN PROGNAME XXNSMA VALUE SCAN PROGNAME XXNSCN VALUE CATALL PROGNAME XXNCAT VALUE ADARUN PROG USER PROGNAME XXNUSR VALUE SEZUNLD PROGNAME XXSULD VALUE SEZLOAD 139 SEZAM Administration Manual PROGNAME XXSLOD VALUE SEZDEL PROGNAME XXSDEL VALUE SEZLIST PROGNAME XXSLST VALUE INPL PROGNAME XXNINP VALUE SYSTRANS PROGNAME XXNTRS VALUE SYSOBJH PROGNAME XXNOBJ NONE IGNORE END DECIDE EXAMINE USERNAME FOR GIVING LENGTH LENGTH check username length IF LENGTH LE 3 THEN COMPRESS USERNAME M SUBSTRING PROGNAME 3 4 INTO OUTPUT LEAVING NO
93. nt status of the saved job Created Date of creation together with the name of the user who has created the current saved job Modified Date of last modification together with the name of the user who has modified the job Locked Date of putting the job in the lock status together with the name of the user who has locked the current saved job Submitted Date of last submit together with the name of the user who has submitted the job After successfully execution the following message is displayed SEZ0201 Job s sysinfo browsed successfully 87 SEZAM Administration Manual 14 03 08 Saved job maintenance System information 2003 08 T2 Command gt 2 Help Job SADA ADASAV Description ADASAV TWOCOPIES TO VTS1 2000 08 24 Owner KSM Status Acive gt Active Modified Disposition gt Keep Date gt 2000 11 18 Locked gt Unlocked User KSM Restriction gt Restricted Submit gt Open Locked Daters Yser s Submitted Des gt Yser gt Enter PEIS PEA PES PEA APESS PFO PRI PERR PRY PEIO PEII PFI Help Exit Figure 8 8 System Information Screen 88 SEZAM Administration Manual Modify Saved Job To modify the saved job take the following steps Enter ED EDIT JOB as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job The ED direct command can also b
94. of JCL 10 SEZAM Administration Manual For the shown above example the independent and dependent parts are represented in Figures 2 3 2 4 KSMFASAV JOB 999 KSM CLASS W MSGCLASS X SEZ312 F177 ADASAV Save files FILE 18 SEZENV F177 ROUTE XEQ DAEF JOBPARM SYSAFF DAEF ROUTE PRINT DAEF STEPO1 EXEC PGM ADARUN REGION 8000K TIME 1440 EC STEPLIB DD DSN RZDBA DB177 NEWLOAD DISP SHR PE DD DSN RZDBA DB177 LOAD DISP SHR DDASSOR1 DD DSN DB177 SYSF ASSOR1 DISP SHR DDDATAR1 DD DSN DB177 SYSF DATAR1 DISP SHR DDWORKR1 DD DSN DB177 SYSF WORKR1 DISP SHR DIS E NE DSE IN T AN IRE DDDRUCK DD SYSOUT DDPRINT DD SYSOUT DDCARD DD ADARUN PROG ADASAV ADARUN SVC 249 ADARUN DEVICE 3390 ADARUN MODE MULTI ADARUN DBID 177 DDKARTE DD Di 24 WD BR i Ja ISC ab END GENERATION Figure 2 3 Independent JCL part JE IN JD 35 2 E INE IBY NE 12 JA i DDSAVE1 DD DSN ADASAV DAEF DB177 F018 DISP KEEP JAA UNIT 3480 LABEL 1 SL EXPDT 98000 VA VOL RETAIN SER KSM001 TRICH COMP JE ING IBY 3 22 UR INE i RI PA ROP ADASAV SAVE FILES 18 ADASAV UTYPE EXU ADASAV NOUSERABEND Figure 2 4 Dependent JCL part 11 SEZAM Administration Manual The dependent part has always two components Utility specific dataset component DDSAVE1 DD DSN ADASAV DAEF DB177 F018 DISP KEEP UNIT 3480 LABEL 1 SL EXPDT 98000
95. of the Saved job maintenance function 5 Saved job maintenance The list of all already created saved jobs will be shown Fig 8 1 17213 48 Saved job maintenance Jobs list 2003 08 12 Command gt SCROLL gt PAGE CM Command help Library gt KSM Object gt DUMMY_ Co Job name Owner Job description User AD L R S Date SABES 2007 ADURO 2003 03 20 __ A BS2000 2 A D U R O 2002 12 k DAS KSM A DU NO 200507 10 MESA SISTE AD UE O 20021211 SAER AERULD ENTIRE DB AERULD A UR O OO 10221 __ SAER LOAD ENTIRE DB AERLOD AE UY O 2001 07 23 1 CST43I CSFLOAD LOAD UPDATED CODE KR UR 9 2001022415 CST431 CSHLOAD LOAD UPDATED HELP MoI UW OO ll CST431 CSMLOAD LOAD UPDATED MODELS AO O 200102415 HRS ESMASE CVE ENE CONVERT EXISTING H AIK U R 2001 0026 Total records gt 10 eee il a a aaas I F j aes 9 PI OSS SSP 2 gt Help Exit Refr Figure 8 1 Saved Jobs List Screen 79 SEZAM Administration Manual The information shown in Figure 8 1 includes the following Information Description ALLOWED USER List of the users who are authorised to execute the job DATE JOB NAME JOB DESCRIPTION OWNER STATUS A STATUS D STATUS L STATUS R STATUS S TOTAL RECORDS 80 up to 8 bytes Date of the last modification Name of saved job Description of saved job Name of the job s owner If the dynamic tran
96. om aO SO O n a nann anann ana 2003 08 12 Command gt CM Command help Enter the history processing parameters Function gt L Record type gt A Search limit gt 0 gt 2003 08 12 gt 20030312 Starting from date Ending at date Enter 21 22 93 M94 7 LOSS 1 11 2 Help Exit Defaults Figure 6 2 History Maintenance Screen 63 SEZAM Administration Manual List Records To list the history records for a given period of time do the following Enter L LIST RECORDS on the history maintenance screen Fig 6 2 Function gt L Specify type of the history records Fig 6 2 Record type gt A S system records U user records A all records Specify maximum number of records found before the list function is terminated Fig 6 2 Search limit gt 0 If zero is specified the search is unlimited The parameter is ignored unless the extended processing routine is specified Enter on the history maintenance screen Fig 6 2 the time period Starting from date gt 2003 08 11 Ending at date gt 2003 08 12 All the records for the given criteria are shown in Figure 6 3 After successfully processing the following message is displayed E History records listed successfully 64 SEZAM Administration Manual U3 08 12 gt PAGE 003 08 11 003 08 12 PF12 1830308 Estoy meaee
97. on gt ALL Rule gt Y Description gt Y Enter target environment Environment gt DB003 irte 2 SPN a 010 271 l Hel Exit Figure 5 14 Copy Environment Screen Verify Environment To check if the environment has been set up properly do the following Enter VE VERIFICATION ENVIRONMENT as direct command in the Command field on the environment list screen Fig 5 1 or as line command in the Co field against the appropriate environment If the command was entered as direct command enter the name of environment being verified Fig 5 15 If no errors was detected in the environment definition the following message is displayed SEZ0147 Environment verified successfully Otherwise the screen with verification protocol appears Fig 5 16 and the corresponding message is displayed SEZ0144 Environment verified with errors warnings 46 SEZAM Administration Manual 15 48 46 Environment maintenance Environment verification 2003 08 11 Command gt Enter environment to be verified Environment gt DB002 lares 2 lai 5 12a Git 100 327 11211 2 Help Exit Figure 5 15 Example of Enter Environment Screen 16 06 17 Environment maintenance Environment verification 2003 08 11 Command gt SCROLL gt PAGE 2 els Environment gt DB002 Index Type Message ily Error Statement PROG PR
98. only for the SEZAM Administrators granted with SEZAM administrative authority the commands of type U can be processed only if the authorisation routine defined in the user exit SNOOUEX1 terminates with the zero response code For more information refer to SEZAM Installation Manual section N is undefined Total number of records SEZAM Administration Manual Environments To get the list of all users who are authorised to operate with the specified ADABAS files within the specified SEZAM environment perform the following Enter corresponding function code in the Function field on the SEZAM Retrieval menu Fig 3 4 3 Environments Enter environment and ADABAS file number for which the cross reference information should be displayed Fig 10 3 The list of all users who may operate with selected ADABAS files within selected environment are shown in Figure 10 4 To get the detailed information about user s definition enter BR BROWSE USER as direct command in Command field or as line command in the Co field If command was issued as direct command enter the user s parameters Fig 4 4 The example of detailed user s definition is shown in Figure 4 5 NAS a REE O SSS ANOS Aes Command gt CM Command help Enter cross reference information Environment gt F177 File gt E II O E Help Exit Figure 10 3 Environment Cross Reference Screen 115 SEZA
99. or as line command in the Co field against the appropriate environment If the command was entered as direct command enter the name of environment being deleted Fig 5 15 Enter the name of environment to confirm the delete of the rule Fig 5 23 After successfully processing the following message is displayed SEZ0212 Job name rules deleted successfully 13227884 Environment maintenance Delete rule 2003 08 11 Command gt Please confirm delete with the name DB001 gt DB001 Enter PEI PRS PES Pra PES PEO PE PEU PFO PRIO PEL PFA Help Exit Figure 5 23 Delete Rule Screen 58 SEZAM Administration Manual Description Processing The description records comprise the notes on the environment in the free form Create Description To create modify the environment description do the following Enter CDE CREATE DESCRIPTION as direct command in the Command field on the environment list screen Fig 5 1 or as line command in the Co field against the appropriate environment If the command was entered as direct command enter the name of environment which tule have to be processed Fig 5 15 Specify the description Fig 5 24 After successfully processing the following message is displayed SEZ0362 Description accepted successfully C UPA S BA sess Environment maintenance Create description AOS SOS 1a Command gt
100. ral info gt File list gt 812 902 ENter IS E E Help Exit GI Figure 6 5 Browse Record Screen To browse or modify the JCL REXX lines of code press the PFS function key For more information refer to the section History Job Processing 68 SEZAM Administration Manual Delete Single Record To delete the history records one by one execute the following Enter DE DELETE RECORD as line command in the Co field against the appropriate history record on the screen shown in Figure 6 3 Confirm delete of the record with DELETE Fig 6 6 After successfully processing the removed record disappears from the list of history records Fig 6 3 and the following message is displayed SEZ0134 History single record deleted successfully 10320511 History maintenance Delete record AOS 031 2 Command gt 2 Heip The following record will be deleted Environment gt F13000 User gt KSM Command gt EX Date gt 2003 08 11 gel gt Yes Time gt 08 57 35 7 Extended info gt ADASAV RESTORE FMOVE Job location gt Exec Natural info gt File list gt 812 902 Please confirm delete with the word DELETE gt DELETE A Jesss 5 E O SI IS Help Exit Well Figure 6 6 Delete Record Screen The record can also be deleted with the direct command DE Delete Record issued on the JCL Browse Screen Fig 6 7 or the JCL Modify Scre
101. retrieval functions 1 e browse through threshold setting view of cross reference user information Fig 1 3 SEZAM Administration Manual SEZAM UTILITIES Performs SEZAM batch utilities Fig 1 4 For more information consult the SEZAM Utilities Manual SEZAM CORRECTIONS Provides an overview of the applied SEZAM corrections For more information consult the SEZAM Installation Manual E SEZAM OPTIONS Provides an overview of the SEZAM settings For more information consult the SEZAM Installation Manual SEZAM MAINTENANCE USER ENVIRONMENT MAINTENANCE MAINTENANCE HISTORY PARAMETER S LIST MAINTENANCE MAINTENANCE SAVED JOB TRANSLATION TABLE MAINTENANCE MAINTENANCE Figure 1 2 Overview of SEZAM Maintenance functions SEZAM Administration Manual SEZAM RETRIEVAL UTILITIES COMMANDS ENVIRONMENTS Figure 1 3 Overview of SEZAM Retrieval functions SEZAM UTILITIES SEZUNLD SEZLOAD SEZDEL SEZLIST Figure 1 4 Overview of SEZAM Utilities SEZAM Administration Manual 2 SEZAM Basic Principles JCL Generation Process The main goal of SEZAM is to ensure the possibility of the job s dynamically generation and execution for the ADABAS utilities NATURAL utilities NATURAL system commands and NATURAL user programs Jobs can be generated in the different format depending on the operating system z OS z VSE z VM BS2000 OSD
102. s can be represented in one of the following formats MENU SCREENS have a selection list of possible functions The user selects the function using cursor or entering an appropriate number in the Function field at the top of the screen Example of menu is shown in Figure 3 2 ji FUNCTIONAL SCREENS serve for the performing of the various SEZAM administration functions The direct command can be entered in the Command field Example of functional screen is shown in Figure 3 5 a HELP SCREENS contain the help information Example of help screen is shown in Figure 3 6 SS Re CO NS le m a a i ia i la AS OS Command gt SCROLL PAGE CM Command help Environment Section ADARUN DB 54 54 ADARUN DBID 333 DDASSOR1 10 30 DDASSOR1 DD DSN DB333 ASSOR1 DISP SHR _ NODE 3 3 ROUTE XEO MVS ADARUN P 58 53 ADARUN PROG PROG __ ADARUN PLG 56 ADARUN PLOGRQ NO __ _ ADARUN RAI 59 ADARUN UEX2 ADAEX2 CMPRINT 50 CMPRINT DD SYSOUT CMSYNIN 55 CMSYNIN DD Total records gt 55 maret Pw l A A 3 Help Exit Refr E SrER SrtA SrtN Figure 3 5 Record List Functional Screen 22 SEZAM Administration Manual 13943295 2 2 222 necia sia SSS SS SS Se 200S SAL Command direct command s field SCROLL scroll PAGE LINE TOP BOT can be used by PF7 PF8 keys Co line command s field Env Section current database environment section of database environment
103. slation takes place the translation table of the owner is activated Active Status A job can be submitted E job can not be submitted date time restrictions are expired Disposition D job will be deleted after submit K job will be kept Lock Status L job is locked and can not be submitted U job is unlocked Restriction Status R job is time people restricted Job can be processed only by authorised persons and or only within the defined date time N job is unrestricted Submit Status O job is open i e has not been submitted S job was submitted Total number of the saved jobs SEZAM Administration Manual Create Saved Job To create the saved job generate the JCL with GN GENERATE JCL command from the ADABAS NATURAL functional screen and perform the following steps Enter CR CREATE JOB as direct command in the Command field Fig 8 1 Enter parameters of the job being created Fig 8 2 Parameter Description SOURCE JOB NAME Name of the NATURAL object which contains the correct JCL TARGET JOB NAME Name of the saved job DESCRIPTION Description of the saved job DISPOSITION Disposition of the saved job D delete after submit K keep RESTRICTION Restriction of the saved job R job is restricted N job is unrestricted For restricted jobs press PF5 and make the following enter restriction values of the job being created Fig 8 3 Parameter Description DATE FROM
104. ss PF10 to get the rule exception screen Fig 5 21 enter the exceptions and press PF6 to accept it press PF3 to return to the create rule screen After successfully processing the following message is displayed SEZ0207 Exceptions accepted successfully To test the rule execute the following steps press PF12 to get the test rule screen Fig 5 22 mark X to select the value of the PROGNAME variable press PF12 to test it The generated job name will be shown in the Jobname field press PF3 to return to the create rule screen After successfully processing the following message is displayed 62 88 Job name rule tested successfully On the create rule screen Fig 5 20 press PF6 to accept the rule together with the exceptions if exist 55 SEZAM Administration Manual IO ASEN Environment maintenance Create rule 2008 01 28 Command gt SCROLL gt PAGE 4 8 ela Select source field name Env A016 Exceptions 15 Userexit UEXRULO1 Co Source field Length ENVIRONMENT 10 I l Nr Source field Start End 1 2 USERNAME 8 PROGNAME 30 1 FUSERNAME____ 1_ pee l 2 A 1 1 l 3 FPROGNAME____ 3_ p2 l 4 l 5 l 6 l 7 l 8 9 10 Himes l 952 Jaen 127 OSes 2 Help Exit Reset Accept Except Test Figure 5 20 Create Rule S
105. successfully execution the following message is displayed EEG JCL cards submitted to operating system successfully MEA A tt ees SM see SSS ANS SA Command II Vv Environment F164 Program ADASAV SAVE The JCL generation completed successfully Please confirm submitting with Y gt Y Enter IS oan GSS DIN Pi J P Y iP ir OPP Lili 12 Help Exit Figure 8 16 Processing Confirmation Screen 97 SEZAM Administration Manual Export Saved Job To copy i e export the saved job from the SEZAM Saved Area into the NATURAL object without placing the saved job into the locked status execute the following steps Enter XP EXPORT JOB as direct command in the Command field on the screen with all jobs Fig 8 1 or as line command in the Co field against the appropriate job Enter the name of the job which have to be exported into the NATURAL object together with the name of the corresponding NATURAL object Fig 8 17 Parameter Description SOURCE JOB NAME Name of the saved job TARGET JOB NAME Name of the NATURAL object where the saved job must be exported Confirm processing Fig 8 18 18280228 H SSS Saved jobs maintenance Export job 2003 08 12 Command gt Enter saved job to be exported source Job name gt SYSMAIN Enter the target job Job name gt JCL003 areen 3 94 eS n J 9 102111112712 Help Exit Figure 8
106. tead of USERNAME 4 output contains jobname 1 3 jobname rule is not used 01 ENVIRONMENT A010 Environment name 01 USERNAME A008 User name 01 PROGNAME A030 Program name for example ADAREP SYSTRANS etc 01 OUTPUT A008 Output The user exit returns the RESPONSE CODE and the OUTPUT The system reaction depends on the RESPONSE CODE RESPONSE CODE 0 The variable OUTPUT must contain the modified value for the user s name which will be used in the standard job name s rule processing instead of the variable FUSERNAME RESPONSE CODE 4 The variable OUTPUT must contain the value for the job s name which will be substituted into the system variable JOBNAME The standard job name s rule processing does not take place The example of the user exit program can be found in the subprograms UEXRUL and in the Appendix D 54 SEZAM Administration Manual Create Rule To create modify the job name rule do the following Enter CRU CREATE RULE as direct command in the Command field on the environment list screen Fig 5 1 or as line command in the Co field against the appropriate environment If the command was entered as direct command enter the name of environment which rule have to be processed Fig 5 15 Specify the rule Fig 5 20 Mark X to select the pre defined SEZAM system variable or enter the every other value directly To define the exceptions pre
107. ter scan and or replace values and confirm processing with the name of the user Fig 8 19 After successfully execution the following message is displayed SEZ0289 Jobs changed successfully 5 occurrence s replaced 14321824 Saas s a Saved jobs maintenance Change jobs AVOS Os 1 2 Command gt Please confirm modification of the 63 saved jobs with the name KSM gt KSM Enter the saved jobs values List records gt Y Record length gt 70 ypperr case gt Y Scan value gt SVC 249 Replace value gt SVC 254 Enter PEL PEL PES PEI PES 27 Si 7 el i 29 Help Exit Figure 8 19 Mass Update Saved Jobs Screen 101 SEZAM Administration Manual 9 Translation Table Maintenance This facility ensures the possibility to create the list of the Translate From magic words which are dynamically searched and replaced to Translate To words The pairs of Translate From Translate To values are stored in the translation tables t tables The facility can be activated for user security passwords which must not by displayed in the plain job text Every user can have a single global Translation table and number of local Translation tables defined one per SEZAM environment By the submitting of the JCL REXX in the current environment will be searched for the local Translation table defined for this environment and then for the global one The entries defined
108. uccessfully 14955254 User maintenance Edit expert person 2003 08 11 Command gt 2 els Enter the file list for the following user User name gt USR001 Environment gt DB001 User info gt USRO0O1 DBO0O1 USROO1 User type gt P Date of creation gt 2003 08 11 Created by gt KSM File list 3 17 133 251 Enter PEL O O O O O IS Help Exit Figure 4 6 Edit Expert Person Screen 30 SEZAM Administration Manual Copy User To copy the user definition from one user to another perform the following steps Enter CO COPY USER as direct command in the Command field on the user list screen Fig 4 1 or as line command in the Co field against the appropriate user Enter parameters of the source and target users Fig 4 7 Parameter Description Required Optional SOURCE Name of user to be copied Required USER NAME SOURCE Name of environment where Required for types M E P ENVIRONMENT source user is defined Don t enter for type A TARGET Name of target user Optional USER NAME If blank is equal to the source name TARGET Name of target environment Optional ENVIRONMENT Tf blank is equal to the source environment After successfully processing the new user appears in the list of SEZAM users Fig 4 1 and the following message is displayed SEZ0017 User copied successfully AAA e 18311808 User
109. wing message is displayed SEZ0416 T tables searched 1 occurrence s found SEZ0415 T tables changed successfully 1 occurrence s replaced 15319817 Translation table maintenance Change tables 2003 08 13 Command gt Please confirm modification of the 3 t tables with the name KSM gt KSM Enter the saved jobs values List records gt Y Scan value gt PUBLIC__ Replace value gt PRIVATE ice 1971 1271 100 619 08 M2 Len 112 Help Exit Figure 9 5 Mass Update Translation Tables 106 SEZAM Administration Manual Browse Translation Table To browse the single Translation table perform the following Enter BR BROWSE T TABLE as direct or line command Fig 9 2 Enter the environment name or leave it empty for the global t table Fig 9 6 After successfully processing the t table will be displayed on the screen and the following message is displayed SEZ0424 T tables browsed successfully 15324222 Translation table maintenance Browse table A003 08 13 Command gt Enter owner of the table being browsed User name gt KSM Environment gt Noia paaa PIP 2 it salmis SD BS ST Gt lill Tn mil 7 Help Exit Figure 9 6 Browse Translation Table 107 SEZAM Administration Manual Modify Translation Table To modify the single Translation table do the following Enter ED EDIT T TABLE as direct or lin
110. within SEZAM This data is accumulated in the history records and can be to retrieve information about the flow of modification of the various SEZAM system objects together with the successfully execution of the following commands EX EXECUTE JCL GN GENERATE JCL SU SUBMIT JCL For information about SEZAM commands consult SEZAM User s Manual The next table shows in the alphabetical order the information which is kept in the history records for the different SEZAM commands COMMAND SYSTEM INFORMATION COMMAND DATE ENVIRONMENT EXTENDED INFORMATION FILES JCL JOB LOCATION TIME USER Figure 6 1 History information 61 SEZAM Administration Manual Detailed description of the information being recorded is shown below Information Description Example COMMAND Name of SEZAM command which was EX executed DATE Date when the event took place in the 2003 08 08 DD MM Y Y Y Y format ENVIRONMENT Name of environment where the current DB001 event took place EXTENDED Detailed information about the function utility ADAORD REORFASSO INFORMATION being processed ADAREP ERRLODUS the executed Adabas Natural program the modified Sezam system object lt type of modification gt source object lt target object gt the executed Sezam utility with the number of modified system objects FILES List of ADABAS files which were accessed in 133 177 the current event lt file numb

SEZAM ADMINISTRATION MANUAL

Contents

Download Pdf Manuals

Related Search

Related Contents