Home

AVAS für den Administrator

image

Contents

1. OF H H DS DS DS H03 H03H03 HO3SLEN HKY 2 ISAM SCHLUESSEL AB VERS 6 0A HISTORY SATZBESCHREIBUNG 2 LUESSEL 03 RKREIS TUM JHYYMMTT DERT JH ART DATE YYMMTT ART TIME HHMISS AME zy PLEX SUM NET JOB HEADER ERT IME E E E JOBS E CONDITIONS E ERRORS ERRORS SAVE FILE U21462 J Z125 7 ATZSCH ENUTZE ET NAM LAN DA AHRHUN LAN S LAN S DAT DEX Lo 0 0 CG zum Go lt KS JOB NAME FU N TYP zt KEYLEN LAENGE RESERVI START T RUN TIM END TIM RUN TIM WAIT TI WAIT TI ANZAHL JRNDAT L2
2. 5325328 DS 0C SATZBESCHREIBUNG SATZ 32 S32JNAM DS CL64 JOB NAME S32JLIB DS CL6 JOB LIB JMDLIB JMDSYS JCLLIB JCLSYS S32JCAT DS CLA JOB CAT S32JCJV DS CL54 JOB CAT JV S32532L EQU 532532A LAENGE DER DATEN S32LEN EQU N3JRNS U21462 J Z125 7 204 Sicherung und Reorganisation Datenstrukturen Journalsicherung Not Journaldatei Definitionen Satzschl ssel 51 ORG N3INH S51 AVASJRN S51 JOURNALSATZ SATZSCHLUESSEL 51 NETZPARAMETER ABLDAT ERSETZT SATZSCHLUESSEL 41 AB VERSION 02 0A S51S51A DS 0C SATZBESCHREIBUNG SATZ 51 5518050 DS CL
3. SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 55 555 209 SATZBESCHREIBUNG SATZ 55 RUN CONTROL SYSTEM NAME EARLIEST START LATEST START RESERVE ET DELAY SOLUTION TEXT ET DELAY SOLUTION CODE m 21m ET TYPE ET USER ET ACCOUNT ET CLASS ET LOG ET CAT OPERATOR STAR TEXT OPERATOR STAR CODE NET PARAMETER LAENGE DER DATEN 0C CL8 CL12 CL12 CL12 0CL6 X CL5 CL1 CL8 CL8 CL8 CL8 CLA 0CL3 X CL2 CL128 S55S55A N3JRNS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS EQU EQU S55A RUCS EARL LATS DSLT DSL TYP USR ACC CLA LGM CAT S55 S55 S55 S55 S55 S55 S55 S55 S55 S55 S55 S55 S550PSTT NPAR S55L LEN S550PST S55 S55 S55 U21462 J Z125 7 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Definitionen Satzschl
4. COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED JRNDAT NET DIRECTORY DESCRIPTION 07 AVSJJDIR 10 AVSONETN PICTURE X 32 10 AVSJUNSTI PICTURE X 10 AVSUNST2 PICTURE X 10 AVSJNST3 PICTURE X 10 AVSJNSTA PICTURE X 10 FILLER PICTURE X 28 S END OF COPY ELEMENT AVSCOBJD TUUM U21462 J Z125 7 435 Cobol Schnittstelle Programmschnittstelle von AVAS AVSCOBUJN Journalsatzkopf definieren Das COPY Element AVSCOBJN beschreibt den Kopf eines Journalsatzes zu einem Netz Aufruf COPY AVSCOBJN Aufl sung des COPY Elements AVSCOBJN COPY AVSCOBJN AVSCOBJN 002 941006 47105176 AVAS U COPYRIGHT C
5. ABLDAT NET DIRECTORY DESCRIPTION 07 AVSDADIR 0 AVSDNETN PICTURE X 32 10 AVSDNSTI1 PICTURE X 10 AVSDNST2 PICTURE X 10 J AVSDNST3 PICTURE X 10 AVSDNERR PICTURE X 10 AVSDNRST PICTURE X 10 AVSDNCWT PICTURE X 10 JAVSDNHLD PICTURE X 0 AVSDNES 15 AVSDNESD PICTURE 9 06 15 AVSDNEST PICTURE 9 06 0 AVSDNLS 07 AVSDADIR 0 AVSDNET PICTURE X 32 10 AVSDNSTI PICTURE X 10 AVSDNST2 PICTURE X 10 AVSDNST3 PICTURE X 10 AVSDNERR PICTURE X 10 M AVSDNRST PICTURE X 10 AVSDNCWT PICTURE X 10 AVSDNHLD PICTURE X 0 AVSDNES 15 AVSDNESD PICTURE 9 06 15 AVSDNEST PICTURE 9 06 U21462 J Z125 7 421 Programmschnittstelle von AVAS PICTURE 9 06 PICTURE 9 06 PICTURE X PICTURE X PICTURE X PICTURE X PICTURE X 29 T AVSCOBAD AUS U21462 J Z125 7 AVSDNLS 15 AVSDNLSD 15 AVSDNLST AVSDNTYP AVSDNDSL AVSDOPST AVSDNHTW FILLER END OF COPY ELEME zo E EE EN Cobol Schnittstelle 422 Cobol Schnittstelle Programmschnittstelle von AVAS AVSCOBAN Netzstrukturdaten definieren Das COPY Element AVSCOBAN definiert die Beschreibung eines Netzstrukturelements Aufruf COPY 47
6. HOIKEY DS 602 SATZSCHLUESSEL 01 HOlBKR DS CL5 BENUTZERKREIS HOINETN DS 012 NET NAME HOIDTPL DS 0cL8 PLAN DATUM JHYYMMTT HOIDTJH DS 602 JAHRHUNDERT JH HOIPLSD DS Cp PLAN START DATE YYMMTT HOIPLST DS Cp PLAN START TIME HHMISS HOlSYMD DS CL20 SYMDAT NAME HOlIND DS 603 INDE HOlJOBN DS 0150 JOB NAME HOLFUNK DS FU N J P X HOISTYP DS 603 TYP SUN NET JOB HOIKLEN EQU HOlKEY KEYLE HOIHLEN EQU HOIHOL LAENGE HEADER DS CLIO RESERVIERT HOlLSTT DS 09 LAST START TIME HOILRNT DS 9 LAST RUN TIME HOLLENT DS 09 LAST END TIME HOlANZA DS ANZAHL ABLAEUFE HOIDURT DS 69 MITL RUN TIME HOIMART DS CL9 MAX RUN TIME HOIMIRT DS CL9 MIN RUN TIME HOIRANG DS 9 RANGE HOISTDA DS 9 STANDARDABWE I CHUNG U21462 J Z125 7 PA PA P P P P P P P P P P P P PA PA EM Aufbau der History Datei 222 Sicherung und Reorganisation Aufbau der History Datei HOIDRTJ DS CL9 L RUN TIME JOBS HOIMRTJ DS CL9 MAX RUN TIME JOBS HOIDWTC DS CL9 MITL WAIT TIME CONDITIONS HOIMWTC DS CL9 MAX WAIT TIME CONDITIONS HOIDWTE DS CL9 MIT
7. HO4H04 DS OF SATZBESCHR HISTORY KEY 04 HO4SLEN DS H SATZLAENGENFELD DS H RESERVIERT HKY AVASJRN H04 EQU NO SATZBESCHREIBUNG HISTORY ISAM SCHLUESSEL AB VERS 6 0A HOAKEY DS CL2 SATZSCHLUESSEL 04 HO4BKR DS CL5 BENUTZERKREIS HOANETN DS CL12 NET NAME HO4DTPL DS OCL PLAN DATUM JHYYMMTT HO4DTJH DS CL2 JAHRHUNDERT JH HO4PLSD DS cL6 PLAN START DATE YYMMTT HO4PLST DS Ce PLAN START TIME HHMISS HOASYMD DS CL2O SYMDAT NAME HOAIND DS 3 INDEX HO4JOBN DS 00 JOB NAME HOAFUNK DS C FU N J P X HOASTYP DS 603 TYP SUM NET JOB HOAKLEN EQU HO4KEY KEYLEN HOAHLEN EQU H04H04 LAENGE HEADER DS CLIO RESERVIERT HO4STT DS CL19 START TIME HOARNT DS CL9
8. COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED ABLDAT CONDITION DESCRIPTION 07 AVSBACON LO FILLER PICTURE X 2 LO AVSBCCR 15 AVSBCCRD PICTURE X 6 15 AVSBCCRT PICTURE X 6 0 AVSBCTXT PICTURE X 120 0 AVSBCDOC PICTURE X 43 0 AVSBCLU 15 AVSBCLUD PICTURE X 6 15 AVSBCLUT PICTURE X 6 0 FILLER PICTURE X 3 07 FILLER REDEFINES AVSBACON 10 AVSBCVAL PICTURE X 128 LO FILLER PICTURE X 64 07 FILLER REDEFINES AVSBACON 10 AVSBNNAM PICTURE X 32 10 AVSBCIND PICTURE X 3 0 AVSBCWUD PICTURE X 6 0 AVSBCWUT PICTURE X 6 0 AVSBSTUS PICTURE X 0 FILLER OCCURS 12 TIMES 15 AVSBCOCO PICTURE X 0 AVSBCOST PICTURE X 128 0 FILLER PICTURE X 4 ERR END OF COPY ELEMENT AVSCOBCE BAR 434 U21462 J Z125 7 Programmschnittstelle von AVAS Cobol Schnittstelle AVSCOBUJD Netzverzeichnisbeschreibung Journaldatei definieren Aufruf COPY AVSCOBJD Aufl sung des COPY Elements AVSCOBJD COPY AVSCOBJD AVSCOBJD 003 941128 47105175 AVAS U
9. JOURNALSATZ SATZSCHLUESSEL 57 CONDITION ABLDAT FUNCTION A C D M W S57S57A DS 0C SATZBESCHREIBUNG SATZ 57 S57CTYPT DS 0CL3 COND TYPE NET JOB RES VAL TIM TEXT S57CTYP DS X COND TYPE CODE DS 602 DS CL3 RESERVIERT 5570571 DS 603 SYNC INDEX S57CVAL DS 2 001256 CONDITION VALUE S57COCV DS 61128 2 OCCURE VALUE S57CERV DS Cll28 ERROR VALUE S57CRBN DS 02 CREATED BY NET NAME 5570881 DS 603 CREATED BY INDEX S57CSTA DS 00110 COND STATUS TEXT 5570510 DS x COND STATUS CODE DS c19 5575571 EQU S57857A LAENGE DER DATEN S57LEN EQU N3JRNS U21462 J Z125 7 211 Sicherung und Reorganisation Definitionen Satzschl ssel 58 N3INH ORG AVASJRN 8 S58
10. SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 15 5155158 DS 0C SATZBESCHREIBUNG SATZ 15 S15FNAM DS 60 FORMAT NAME SISFTXT DS 00 FORMAT TEXT S15S15L EQU S15S15A LAENGE DER DATEN S15LEN EQU N3JRNS 202 U21462 J Z125 7 Sicherung und Reorganisation Datenstrukturen Journalsicherung Not Journaldatei Definitionen Satzschl ssel 16 ORG N3INH S16 AVASJRN S16 SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 16 5165168 DS 0C
11. COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED AVAS BATCH PROGRAM INTERFACE WORK AREA DI AVASBWRK 05 AVSWAREA 0 AVSWMGCT PICTURE S9 4 COMPUTATIONAL VALUE IS 3 LO AVSWMGCR PICTURE S9 4 COMPUTATIONAL LO AVSWFILE PICTURE X 54 LO FILLER PICTURE X 22 05 AVSWMTAB OCCURS 3 TIMES LO AVSWMPAR 5 FILLER PICTURE S9 4 COMPUTATIONAL 5 FILLER PICTURE X 5 AVSWMSGS PICTURE X 5 AVSWMSG 17 AVSWMSGK PICTURE X 03 17 AVSWMSGN PICTURE X 04 5 AVSWMSGT PICTURE X 125 KER END OF COPY ELEMENT AVSCOBBW TROU Hinweis Durch die REPLACE Klausel wurde der Wert von AVSBMGCT VALUE IS 3 und die OCCURS Klausel bei AVSWMTAB modifiziert 432 U21462 J Z125 7 Programmschnittstelle von AVAS Cobol Schnittstelle AVSCOBCD Verzeichniseintrag Bedingungseintr ge in Ablaufdatei definieren Das COPY Element AVSCOBCD beschreibt einen Eintrag im Verzeichnis der Bedingungs eintr ge Aufruf COPY AVSCOBCD Aufl sung des COPY Element
12. R ZDD R ZDL JOBLOG ES NO Wee NUE GSDATEI 0 UEHREN YES NO R PHASE LIB SYSPRG AVAS 070 SYSTEM Beispiel BEGIN PROC LOGG CMD PAR YES PROC PAR amp SYSID EI DE EI DE DAT EN NET CHERU ES FUER ZDD UEBERWACHUNG C amp EOPW B EOPW B OUR JR ALL FUEHRE TE PLA ch AL SI REN Y amp FUNKTION CABLDAT SJOUR JRNDAT JOBLOG amp IGNLT YES amp DELPN YES amp ZDDPW STD amp ZDLPW STD amp AVSID amp USRPW amp JLDELS STD amp JLSVOZYES amp DELJL YES amp NETN amp JVZDD 2 SSFILE AVAS USER JRNDAT SAVE ESC CHAR REMAR REMARK amp SYSID SYSTEM ID REMARK amp ZDDPW ZDD PASSWORD SIEHE R REMARK amp ZDLPW ZDL PASSWORD SIEHE R REMARK amp FUNKTION FUNKTION ABLDAT SJ REMARK amp NETN NETZNAME BK NETNAME REMARK amp DELPN DELETE PLAN NET DURCH REMARK amp AVSID AVAS USERID FUER DELE REMARK amp USRPW USER PASSWORD SYNTAX REMARK amp SFILE PRAEFIX FUER DIE JOUR REMARK amp JLSVO JOBLOG
13. U21462 J Z125 7 Definitionen Satzschl ssel 52 L 52 JOB PARAMETER ABLDAT L 42 AB VERSION 02 0A mm SATZBESCHREIBUNG SATZ 52 TYP TEXT TYP COD m START IND SYNC INDE STATUS 1 E STATUS 1 L Ze rn co e Cc m STATU 5 2 STATUS 2 C oO m oO m STATU EX STATU COD S S ww m BEENDIGUNGSGRUND FUNKTION ANZAHL ABHAENGIGKEITEN VORHANDEN ANZAHL ABHAENGIGKEITEN ERFUELLT NORMALE LAENGE DER DATEN BS2000 TSN AUS MONJV TEXT AUS DER MONJV 5 5 TART CATID DES JOBS TART DATUM DES JOBS SONDER LAENGE DER DATEN SATZSCHLUESS ERSETZT SATZSCHLUESS NH N3I ORG AVASJRN S52 0C 0CL3 52552A 28 52552A 3JRNS X CL2 CL3 CL3 0601 X CL9 0601 X CL9 0CL1 X CL9 CL2 CL1 XL2 XL2 KS CLA CL CL4 CL8 KS JOURNALSATZ DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS D
14. COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 7 7 ALL RIGHTS RESERVED RESULT DESCRIPTION 07 AVSERSLT 10 AVSEOPAR PICTURE X 64 10 FILLER REDEFINES AVSEOPAR 15 AVSENETN PICTURE X 32 15 AVSEEAS 17 AVSEEASD PICTURE 9 06 17 AVSEEAST PICTURE 9 06 5 AVSESYND PICTURE X 20 10 FILLER REDEFINES AVSEOPAR 5 FILLER PICTURE X 32 5 AVSERSVT PICTURE 9 15 FILLER PICTURE X 31 LO FILLER REDEFINES AVSEOPAR 15 AVSENAME PICTURE X 43 15 FILLER PICTURE X 21 LO FILLER REDEFINES AVSEOPAR 15 AVSECDNM PICTURE X 30 1 5 FILLER PICTURE X 34 0 FILLE PICTURE X 03 0 AVSERLT 5 AVSERLTC PICTURE X 88 AVSQPART VALUE AVSR PARTIALLY 88 AVSQCREA VALUE AVSR CREATED 88 AVSQSUBM VALUE AVSR SUBMITTED 88 AVSQERR VALUE AVSR ERROR 88 AVSQREST VALUE AVSR RESTARTED 88 AVSQPLAN VALUE AVSR PLANNED 88 AVSQNOPL VALUE AVSR NOPLAN 88 AVSQSAVE VALUE AVSR SAVED U21462 J Z125 7 437 Cobol Schnittstelle Programmschnittstelle von AVAS AVSR UPDATED AVSR NOUPDATE 88 AVSQUPDT VALU 88 AVSQNOUP VALU 88 AVSQNOS
15. COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED AVAS BATCH PROGRAM INTERFACE COMMUNICATION AREA AVASBCOM AVSRAREA 10 AVSRCMDT PICTURE X 24 10 AVSRFDB PICTURE S9 4 COMPUTATIONAL FUNCTION WITHOUT ERROR 88 0 VALUE 0 FUNCTION WITH WARNING 88 AVSQNOK VALUE 4 ASSIGNMENT ERROR 88 AVSQCMDE VALUE 1025 OPERAND ERROR 88 AVSQOPRE VALUE 1026 PARAMETER ERROR 88 AVSQPRME VALUE 1027 FUNCTION WITH ERROR 88 AVSQFCTE VALUE 1028 ERROR ABOUT OUT AREA 88 AVSQOUTE VALUE 2049 DMS ERROR ABOUT OUT AREA 88 AVSQODMS VALUE 2050 ERROR ABOUT WRK AREA 88 AVSQWRKE VALUE 3073 DMS ERROR ABOUT WRK AREA 88 AVSQWDMS VALUE 3074 AVAS SYSTEM ERROR 88 AVSQAVSY VALUE 4609 10 FILLER PICTURE S9 4 COMPUTATIONAL 10 FILLER PICTURE X 04 U21462 J Z125 7 Cobol Schnittstelle Programmschnittstelle von AVAS LO AVSRNECT PICTURE S9 4 COMPUTATIONAL LO AVSRNEOK PICTURE S9 4 COMPUTATIONAL 0 AVSRNEER PICTURE S9 4 COMPUTATIONAL 0 AVSRRLTC PICTURE X 0 FILLER PICTURE X LO AVSRDMSN PICTURE X 04 LO AVS
16. S58S58A S58TYPT S58TYP S58ESTI S58ESYI S58EIND S58EJOB KS S58RVA S58RIN S58RJOB S58RTYPT S58RTYP S58RTYAT S58558L SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 58 5 ERSETZT SATZSCHLUESSEL 68 AB VERSION 2 5 DS 0C SATZBESCHREIBUNG SATZ 58 DS 0CL3 TYPE TEXT DS X TYPE CODE DS CL2 DS CL3 START INDEX DS CL3 SYNC INDEX DS C RESERVE DS CL3 ERROR INDEX DS CL30 ERROR NAME DS CL2 RESERVE DS CL1 RESTART VARIANT DS CL3 RESTART INDEX DS CL30 RESTART NAME DS CL2 RESERVE DS 0CL10 RESTART TYPE TEXT DS X RESTART TYPE CODE DS CL9 DS CL3 AUTOMATIC YES NO EQU S58S58A LAENGE DER DATEN EQU N3JRNS U21462 J Z125 7 S58LEN Datenstrukturen Journalsicherung Not Journaldatei 212 Sicherung und Reorganisation Datenstrukturen Journalsicherung Not Journaldatei Definitionen Satzschl ssel 59 ORG N3INH 59 AVASJRN S59 ke ee khe hehe he he hee ek kk e ke hehehe he he he ke ek kk be b he hehe he he ke he kk e he he he he he ke he ke he ke he hee 7 JOURNALSATZ SATZSCH
17. Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien 4 1 4 Anweisungen f r das Reorganisationsprogramm Das Reorganisationsprogramm liest seine Anweisungen ber SYSDTA Abh ngig von der Anweisung FUNKTION k nnen oder m ssen weitere Anweisungen gegeben werden bersicht der Reorganisationsfunktionen und der ben tigten Reorganisations anweisungen FUNKTION JRNDAT SJOUR ABLDAT JOBLOG HISTORY AVAS SYSTEM ID ja ja ja ja ja AVAS USER ID ww 2 ww 2 ww 2 ww 2 ww 2 DELETE JOB LOG nein nein nein ww nein DELETE PLAN NET nein nein ww nein nein END ww ww ww ww ww HISTORY DELETE DATE nein nein nein nein ww HISTORY DELETE OPTION nein nein nein nein ww HISTORY KEEP RECORDS nein nein nein nein ww HISTORY SAVE OPTION nein ww nein nein nein JOBLOG DELETE DATE nein nein nein ww nein JOBLOG DELETE STATUS nein nein nein ww nein JOBLOG SAVE LINK nein nein ww 1 ww 1 nein JOBLOG SAVE OPTION nein nein ww ww nein NET NAME ww ww ww ww ww OUTPUT FILE nein ww nein nein nein OUTPUT LINK NAME nein ww nein nein nein PERIOD NAME nein nein ja nein nein START ww ww ww ww ww USER PASSWORD ww 2 ww 2 ww 2 ww 2 ww 2 ZDD PASSWORD ww 4 ww 4 ww 4 ww 4 ww 4 ZDL PASSWORD ww 4 ww 4 ww 3 4 ww 3 4 ww 4 ja Anweisung muss angegeben werden nein Anweisung wird f r die Funktion
18. SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 31 5315318 DS 0C SATZBESCHREIBUNG SATZ 31 S31EARL DS CL12 EARLIEST START 531151 DS CL7 LATEST START INPUT NPRLIB 531158 DS CL12 LATEST START OUTPUT ABLDAT S31LFTI DS CL7 LIFE TIME INPUT NPRLIB S31LFTA DS CL12 LIFE TIME OUTPUT ABLDAT S31RUCS DS CL8 RUN CONT SYS S31NDSLT DS 0CL6 NET DELAY SOLUTION TEXT S31NDSL DS X NET DELAY SOLUTION CODE DS CL5 S31NTYP DS CL1 NET TYPE S31NCAT DS CLA NET CAT S31NCJV DS CL54 NET CAT JV S310PSTT DS 0CL3 OPERATOR STAR TEXT S310PST DS X _ OPERATOR STAR CODE S31SYMD DS CL20 _ SYMDAT DS CL2 5315311 EQU 5S318531A LAENGE DER DATEN S31LEN EQU N3JRNS Definitionen Satzschl ssel 32 ORG N3INH S32 AVASJRN 2 SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 2
19. Installation und Generierung DSECT AVASEXKO EXITNAM USINFO PFIX VUS DS or AVAS EXIT VERSTAENDIGUNGSBEREICH DS F LAENGE VERSTAENDIGUNGSBER DS op RETURNCODE DER EXIT ROUTINE DS CL3 DS C FUNKTIONSCODE EQU xX 00 FUNKTION AUSFUEHREN EQU X 02 MODIFIKATION DURCHFUEHREN X 04 FUNKTION NICHT AUSFUEHREN EQU X 06 FUNKT SCHRITT NICHT AUSFUEH EQU une FUNKTION ABBRECHEN EQU X 12 MODI INSERT DURCHFUEHREN EQU X 14 MODI DELET DURCHFUEHREN DS F BS2000 TS Ds EE AVAS SYSTEM ID DS CL8 AVAS BENUTZERNAME DS Cp AVAS NETZ BENUTZERKREIS DS CL8 RUN CONTROL SYSTEM DS CL20 KALENDERNAME 79 Beispiel name USINFO USINFO USLEN RTC mox ook C USNO USIG USABE SNUI USTS USAPP USUSR USASK USCAL lt lt lt lt lt lt lt lt lt lt lt lt lt lt U21462 J Z125 7 RZ Exits im AVAS System Installation und Generierung 2 4 4 2 Kommunikationsbereiche Der Kommunikationsbereich enth lt Daten die AVAS aus der Funktion heraus der RZ Rou tine bergibt F r jeden RZ Exit muss der entsprechende Kommunikationsbereich verwen det werden Die Feldbeschreibungen der Kommunikationsbereiche k nnen ebenfalls mit dem Makro AVASEXKO erstellt werden Eine DSECT Anweisung muss der Benutzer selbst davor setzen Der Aufruf hat folgendes Format name AVASEXKO EXITNAM exitL PFIX pfix Dabei gibt exit den
20. AVAS ASSIGNMENT AVSA SIGNON IS 12 AVSA END IS 20 AVSA READ AVAS LIB IS 52 AVSA CREA PLAN NET IS 62 AVSA CREA PROD NET IS 69 AVSA SUBMIT NET IS 72 AVSA RESTART NET IS 78 AVSA MOD COND DES IS 89 AVAS RESULT STATE AVSR PARTIALLY IS 11 AVSR CREATED IS 12 AVSR SUBMITTED IS 15 AVSR ERROR IS 23 AVSR RESTARTED IS 28 AVSR PLANNED IS 124 AVSR NOPLA IS 125 AVSR SAVED IS 128 AVSR UPDATED IS 130 AVSR NOUPDATE IS 131 AVSR NOSUBMIT IS 134 AVSR NOTFOUND IS 139 AVSR LOCKED IS 140 zen END OF COPY ELEMENT AVSCOBBQ sek gt PUNKT FUER SPECIAL NAMES ERFORDERLICH U21462 J Z125 7 431 Cobol Schnittstelle Programmschnittstelle von AVAS AVSCOBBW Arbeitsbereich definieren Aufruf COPY AVSCOBBW REPLACING COUNT BY integer 0 999 gt COUNT Beschreibt die Gr e einer Tabelle In diesen Bereich werden Meldungen die bei der Bearbeitung einer BATCH Anweisung auftreten in tabellarischer Form abgelegt integer 0 999 lt Anzahl der Tabellensegmente COUNT O zeigt an dass kein Bereich ange legt reserviert werden soll Aufl sung des COPY Elements AVSCOBBW COPY AVSCOBBW REPLACING COUNT BY 3 AVSCOBBW 002 941006 47100688 AVAS U
21. Programmschnittstelle von AVAS 15 AVSNJENT PICTURE X 15 AVSNJUSE PICTURE X 08 15 AVSNJACC PICTURE X 08 15 AVSNJCAT 17 AVSNICTK PICTURE X 17 AVSNJCTI PICTURE X 04 17 AVSNJCTI PICTURE X 04 17 FILLER PICTURE X 5 AVSNJCLA PICTURE X 08 5 AVSNJLGM PICTURE X 08 15 AVSNJPAR PICTURE X 128 5 AVSNJFIL PICTURE X 54 TYPE NET FILLER REDEFINES AVSNVANF 15 AVSNSNLD PICTURE X 08 15 FILLER PICTURE X 06 5 AVSNSUSE PICTURE X 08 5 AVSNSACC PICTURE X 08 15 AVSNSSRV PICTURE X 08 15 AVSNSCAT REDEFINES AVSNSSRV 17 AVSNSCTK PICTURE X 17 AVSNSCTI PICTURE X 04 17 FILLER PICTURE X 15 AVSNSCLA PICTURE X 08 15 AVSNSLGM PICTURE X 08 15 AVSNSPAR PICTURE X 128 END OF COPY ELEMENT AVSCOBAN vr U21462 J Z125 7 Cobol Schnittstelle FUNCTION S 10 426 Cobol Schnittstelle Programmschnittstelle von AVAS AVSCOBBC Kommunikationsbereich definieren Das COPY Element AVSCOBBC definiert den Kommunikationsbereich f r alle BATCH Funktionen 427 AVSCOBBC COPY Aufruf Aufl sung des COPY Elements AVSCOBBC COPY AVSCOBBC AVSCOBBC 002 941006 47100686 AVAS U
22. END OF COPY ELEMENT AVSCOBBO AVAS BATCH 01 AVASBOUT 03 AVSOAR 05 0 05 FILL 05 0 05 FILL 03 AVSOTA 430 Programmschnittstelle von AVAS Cobol Schnittstelle AVSCOBBO Schl ssel f r AVSCMDC und AVSERLTC definieren Das COPY Element definiert die Schl ssel f r den Funktions und den Result Code der Schnittstelle Aufruf COPY AVSCOBBQ Beispiel mit Aufl sung des COPY Elements AVSCOBBQ SPECIAL NAMES TERMINAL IS USER INOUT SYMBOLIC CHARACTERS COPY AVSCOBBO AVSCOBBQ 002 941006 47100689 AVAS U COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED
23. 1 V I V I V I MODIFY FILE ATTRIBUTES FILE NAME amp NETSYM SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMA AME DER AUSGABEDATEI FUER NETTEXTTAB amp NETTXT SET FILE LI LINK AVSNETT F NAME amp NETTXT MODIFY FILE ATTRIBUTES FILE NAME amp NETTXT SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMARK NAME DER AUSGABEDATEI FUER ORDERTAB amp ORDER LSET FIBESEI LINK AVSORD F NAME amp ORDER MODIFY FILE ATTRIBUTES FILE NAME amp ORDER SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMARK NAME DER AUSGABEDATEI FUER ORDERDOKTAB amp ORDERDOK JSETSRDEE LE LINK AVSORDD F NAME amp ORDERDO MODIFY FILE ATTRIBUTES FILE NAME amp ORDERDOK SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMARK NAME DER AUSGABEDATEI FUER ORDERSYMTAB amp ORDERSYM SET FILE LI LINK AVSORDS F NAME amp ORDERSYM MODIFY FILE ATTRIBUTES FILE NAME amp ORDERSYM SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMARK NAME DER AUSGABEDATEI FUER ORDERSTURNTAB amp ORDERTUR SET FILE LI LINK AVSORDT F NAME amp ORDERTUR MODIFY FILE ATTRIBUTES FILE NAME amp ORDERTUR SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATIO
24. SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 12 V2 0 5125128 DS 0C SATZBESCHREIBUNG SATZ 12 SI2TYPT DS 0CL3 TYPE TEXT STD MOD NET JOB RES VAL EXT JVA S12TYP DS X TYPE CODE DS CL2 DS C RESERVIERT S12SYMD DS CL20 SYMDAT DS C RESERVIERT SI2LATS DS CL7 LATEST START OCCURE OCCURE TIME S12DSLT DS 0CL6 DELAY SOLUTION TEXT S12DSL DS X DELAY SOLUTION CODE U21462 J Z125 7 200 Datenstrukturen Journalsicherung Not Journaldatei 201 LIFE TIME SYNC INDEX RESTART PUNKTE RESTART VARIANTE 1 RESTART INDEX V1 RESTART JOB V1 RESERVIERT RESTART TYP V1 TEXT RESTART TYP V1 CODE AUTOMATIC YES NO TEXT RESTART VARIANTE 2 RESTART INDEX V2 RESTART JOB V2 RESERVIERT RESTART TYP V2 TEXT RESTART TYP V2 CODE AUTOMATIC YES NO TEXT RESTART VARIANTE 3 RESTART INDEX V3 RESTART JOB V3 RESERVIERT RESTART TYP V3 TEXT RESTART TYP V3 CODE AUTOMATIC YES NO TEXT RESERVIERT SELECT RESTART VARIANT LAENGE DER DATEN Sicherung und Reorganisation 615 CL7 CL3 3CL48 S12JRSP 0CL48 CL3 CL30 CL2 0CL10 X CL9 CL3 0CL48 CL3 CL30
25. ODIFY PLAN NET odifikation odifikation odifikation Fehlermeldung DELETE PLAN NET Start des L schens L schen Job Fehler beim L schen Ende der Funktion Abbruch der Funktion Fehlermeldung COLLECT NET PAR Start der Funktion verarbeiten Maske Fehler Maske Ende der Funktion Abbruch der Funktion Fehlermeldung o N CO OO JO O CO OO Jr CO 00 JE 2 CO OO 010 c0 c OO OO OO kA CH Datenstrukturen Journalsicherung Not Journaldatei Ausgabe im Datenbereich S21 S21 Sed S16 S21 S21 Anweisung Anweisung Anweisung Anweisung Anweisung Anweisung AVASJR X AVASJR X AVASJR AVASJR AVASJRN x AVASJR JCLLIB JCLLIB JCLLIB Baustein JCLLIB JCDLIB xxxxxx AVASJR AVASJR S16 S16 MSG7 Text AVASJRN JMDLIB x JMDLIB x JMDLIB x AVASJRN AVASJRN S16 Anweisung Anweisung Anweisung S16 S16 MSG7 Text S16 S16 AVASJRN AVASJRN MSG7 Text AVASJRN AVASJRN MSG7 Text 193 Sicherung und Reorganisation SSL FNR Anweisung CREATE PROD NET 01 00 Start der Modifikation Netz 21 01 Daten USER PAR FILE 21 01 Systemvariable 21 05 Fehler USER PAR FILE 16 00 Start Modifikation FU J P X 21 01 Daten USER PAR FILE 21 05 Fehler USER PAR FILE 22 00 zuordnen Maske 23 00 Aufruf JCL Baustein 23 00 Aufruf externer Baustein 23 01 Daten externer Baustein 25 01 odifizieren Parameter 25 02 odifizieren Parameter 25 0
26. qp fed 87 2 4 10 RAZL E AVERIJ OS asa os epica REHPREREG en PA or ERA E Rd Fe RR 88 2 4 11 BES AVEA OO astra a qub ERE Een Ea ERA 90 2 4 12 FERNE REN LS sd ea ra a a ar a er 91 2 4 13 EE einen nern 93 2 4 14 RAEM AVEX aaa aan rare each CE Rd a ERE 94 2 4 15 AZE EE a ids E QR ERE dE E AE E dech 56 2 4 16 SE CIO osea ey Sd Ret te kar ERES RR RR ADU kr 98 2 4 17 HERNE TE 99 3 Administration von AVAS 103 3 1 Starten und Beenden der AVAS Prozesse 104 3 1 1 Systemstart und Systemsicherheit 104 3 1 2 Startparameter f r den Dialogprozess se 106 3 1 3 Starten und Beenden der Zugriffsprozesse 107 3 1 4 Starten und Beenden der Ablaufsteuerung 113 3 1 5 Starten und Beenden des Prozesses Server berwachung 121 3 2 Bedienen und berwachen der AVAS Prozesse ii 127 92 1 Bedienen der Zugriffsprozesse 127 3 2 2 Bedienen der Ablaufsteuerung 129 3 2 3 Serverumgebung im Prozess Server berwachung modifizieren 131 3 2 4 berwachen der Prozesse ber Jobvariablen 133 3 3 Administrationsaufgaben im Betrieb 135 3 3 1 Verwalten der Systembibliotheken 22222 n nennen rese 135 3 3 2 Vatrwalten der Benutzer csse code eR rer e denos Ex RO ce EE 135 3 3 3 Verwalten der System Parameterdatei 135 U21462 J Z125 7 Inhalt Verwalten der Ablaufprotokol
27. AVSNRSRV S AVSNHPV AVSNSRVN REDEFINE FILLER 15 AVSNCATI 15 AVSNCATI I 1 1 1 2 AVSNCAT AVSNRS AVSNRST AVSNRSJ AVSNRS 0 LO 0 OoOooooooooooo E CO CH 10 10 10 10 10 U21462 J Z125 7 Programmschnittstelle von AVAS AVSNRST2 PICTURE X AVSNRSJ2 PICTURE X 30 AVSNRSI3 PICTURE X 03 AVSNRST3 PICTURE X AVSNRSJ3 PICTURE X 30 AVSNLTS 15 AVSNLTSD 17 AVSNLTSH PICTURE 9 02 17 AVSNLSTD PICTURE 9 06 5 AVSNLSTT PICTURE 9 06 FILLER REDEFINES AVSNLTS 15 FILLER PICTURE 9 02 15 AVSNLST PICTURE 9 12 AVSNLTO REDEFINES AVSNLTS 15 AVSNLTOD 17 AVSNLTOH PICTURE 9 02 17 AVSNLOCD PICTURE 9 06 15 AVSNLOCT PICTURE 9 06 FILLER REDEFINES AVSNLTS 15 FILLER PICTURE 9 02 15 AVSNLOC PICTURE 9 12 AVSNDSO PICTURE X FILLER PICTURE X 13 VARIABLE AREA ABOUT TYPE AND FUNKTION AVSNVANF PICTURE X 320 TYPE JVA FILLER REDEFINES AVSNVANF 15 AVSNFCN PICTURE X 54 PICTURE 9 03 PICTURE 9 03 15 AVSNVPOS 15 AVSNVLEN PICTURE X 256 TYPE NET FILLER REDEFINES AVSNVANF 15 AVSNCNOC PICTURE X OCCURS 12 TIMES 15 AVSNCNEC PICTURE X OCCURS 12 TIMES 15 AVSNCNC PICTURE X 32 TYPE JOB FILLER REDEFINES AVSNVANF 15 AVSNCJOC PICTURE X OCCURS 12 TIMES 15 AVSNCJEC PICTURE X OCCURS 12 TIMES 15 AVSNCJC PICTURE X 32 15 AVSNCJCI PICTURE 9 03 U2146
28. Bild 6 berblick der AVAS Server Schnittstellen 440 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung und kontrolle f r Server Jobs mit einem AVAS Server auf einem UNIX oder Windows System Jobs auf dem Server System werden ber Strukturelemente mit FUNCTION X gestartet Dabei k nnen die Server Jobs ber die AVAS Bibliotheken verwaltet werden bei TYPE STD oder MOD oder auf dem Server System bereitgestellt werden bei TYPE EXT Bei einem Strukturelement mit FUNCTION X startet die Ablaufsteuerung einen AVAS Agenten AVSSINCM im BS2000 OSD der folgende Leistungen erbringt e Herstellen der Verbindung zum AVAS Server auf dem Server System ber sockets e bertragen des Skripts des Server Jobs TYPE STD oder MOD zum AVAS Server e lnitieren des Starts des Jobs auf dem Server System ber den AVAS Server e bernehmen des Ergebnisses des Job Ablaufs Status ENDED oder ERROR vom AVAS Server e bernehmen der LOG Dateien des Server Jobs und Ablegen unter der BS2000 Benut zerkennung e Ubergeben des Ergebnisses ber die kontrollierende Auftrags Jobvariable an die AVAS Ablaufsteuerung Die erforderlichen BS2000 Komponenten f r den AVAS Server f r UNIX und Windows Systeme werden mit der BS2000 Version von AVAS ausgeliefert Der allgemeine Verfahrensablauf ist im Abschnitt Ablaufsteuerung und
29. 326 U21462 J Z125 7 BATCH Anweisungen CREATE PROD JOB CREATE PROD JOB Erstellen statischer BS2000 Jobs S Prozeduren und Server Jobs Mit CREATE PROD JOB k nnen statische BS2000 Jobs S Prozeduren und Server Jobs in der AVAS Benutzerbibliothek JMDLIB erzeugt werden CREATE PROD JOB INPUT NAME bk jobname OVERWRITE YES NO USER PAR FILE dateiname libname element typ OUTPUT NAME jobname Der Parameter INPUT NAME muss angegeben werden der Parameterwert kann teilquali fiziert angegeben werden Wenn der Parameter INPUT NAME teilqualifiziert angegeben wird wird bei allen erzeugten BS2000 Jobs S Prozeduren und Server Jobs OUTPUT NAME INPUT NAME gesetzt Wenn beim Parameter INPUT NAME der Systembenutzerkreis angegeben wird wird bei den erzeugten Elementen der Benutzerkreis gemap den Anmeldedaten eingesetzt Der Parameter OVERWRITE entspricht dem Wert im Parameterfeld OVERWRITE der Maske AVMO013 Der Parameter USER PAR FILE entspricht dem Wert im Parameterfeld USER PAR FILE der Maske 3 Der Parameter OUTPUT NAME ist nur in Verbindung mit dem vollqualifizierten Parameter INPUT NAME zugelassen Wenn der Parameter OUTPUT NAME nicht angegeben wird wird OUTPUT NAME INPUT NAME gesetzt Der Parameter FORMAT NAME ist nicht zugelassen Protokoll der Verarbeitung F r jeden erzeugten BS2000 Job Server Job bzw f r jede erzeugte S Prozedur wird AVS8521 CREATE PROD JOB jobname RESULT ergebnis ausgegebe
30. n welchen Jobs wird das Pubset ABCD verwendet SELECT bknet netname ordername FROM ordertab WHERE pvs ABCD Welche Jobs laufen auf einem bestimmten Pubset bzw welche Jobvariable enth lt das Pubset Beispiel Welche Jobs laufen auf dem Pubset ABCD SELECT DISTINCT o bknet o netname o ordername FROM ordertab o nettab n WHERE o pvs ABCD OR o bknet n bknet AND o netname n netname AND n pvs ABCD AND o funktion J Von welchem Benutzerkreis wird ein bestimmter Kalender verwendet Beispiel Welche Benutzerkreise verwenden den Kalender EXAMPLECALENDAR SELECT bkcal FROM caltab WHERE calname EXAMPLECALENDAR In welchen Orders wird ein bestimmter SELECT TURNUS verwendet Beispiel In welchen Orders wird der SELECT TURNUS 7 verwendet SELECT bknet netname ordername FROM ordersturntab WHERE selectturnus 7 Zu welchen Orders bzw Netzen gibt es ein Dokument in der DOCLIB und welchen Namen hat es Beispiel SELECT bknet netname bkorder bkdoc dokname FROM orderdoctab WHERE docvorh j 255 U21462 J Z125 7 Fehlerbehandlun Dienstprogramm AVAS QUER g 5 4 Fehlerbehandlung Die erfolgreiche Anmeldung durch SIGNON ist zur Bearbeitung der SELECT OBJECT Anweisung notwendig Wenn dies nicht der Fall ist werden alle SELECT OBJECT Anwei sungen bis zur n chsten SIGNON bzw bis zur END Anweisung bersprungen Wenn beim Offnen der Ausgabedatei en ein Fehler auftritt wird das Pro
31. Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung Folgende Status werden f r die Server Jobs verwendet Bedeutung bertragen des Server Jobs Starten des Server Jobs Server Job l uft Server Job ohne Fehler beendet Server Job fehlerhaft beendet Verbindungsverlust zum Server beim bertragen des Server Jobs Die Verbindung zum Server ist w hrend der Startphase abgebrochen Ende des Server Jobs unbekannt da die Kommunikation nach dem Start aber vor dem Ende des Server Jobs unterbrochen wurde AVSSINCM fehlerhaft beendet da Startparameter f r AVSSINCM oder Authentifizierung fehlerhaft Status Zusatz SF SS RR TT AA EF ES ER PP Folgende Status werden f r mySAP com Jobs verwendet Bedeutung Verbindungsverlust w hrend Bearbeitung Jobende mySAP com Job fehlerfrei beendet Verbindungsverlust w hrend Bearbeitung Jobende mySAP com Job fehlerhaft beendet Fehlerhafte Parameter f r Programm avasr3 Verbindungsverlust zwischen Programmen avasr3 und mySAP com System U21462 J Z125 7 Status Zusatz ET EA AP AE 458 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs 11 3 1 Aufbau der Konfigurationsdatei ber die Server Konfigurationsdatei werden reale Werte Server Rechner Server Userid des Server Jobs den symbolischen Angaben zum Server System in der Netzbeschrei bung zugeordnet Die Konfigurationsdatei wird
32. Beenden von AVAS QUER i Aufbau der von AVAS QUER erstellten Ausgabedatei en Anweisungen von AVAG OUER SIGNON Anmelden an AVAS System CREATE FORMAT Format f r Ausgabedatei ausw hlen SELECT OBJECT AVAS Objekte ausw hlen Datenhaltung f r AVAS QUER i Erstellen der Datenbank 2s cosa causae REL ize kn ds Einbringen der Daten uus eeu sci terme EE Struktur der Datenbank Aufbau der Datenbanktabellen sees Beispiele f r Datenbankabfragen i Fehlerbehandlung eh mm emm Software Voraussetzungen 3 3 4 3 3 4 1 3 3 4 2 3 3 4 3 3 3 4 4 3 3 5 3 3 5 1 4 1 4 1 1 4 1 2 4 1 3 4 1 4 4 3 4 4 5 1 5 1 1 5 1 2 5 1 3 5 1 4 5 1 5 5 2 5 3 5 3 1 5 3 2 5 3 3 5 3 4 5 3 5 5 4 5 5 U21462 J Z125 7 Inhalt 6 Kopplung von AVAS mit MAREN eeseeeee 259 6 1 Durchf hren von Datentr gerpr fungen P 6 2 Eintragen von VSNs in die JC i 3 3 6 2 1 Eintragen von VSNs bei Eingabeb ndern 3 6 2 2 Eintragen von VSNs bei Ausgal r en 6 2 3 non von Fortsetzungszeilen ee een tas Sec 6 3 1 Tansporlite bd Rd pP REC NU IE MAMMA ONERE 6 3 3 Tele 272 6 3 4 Einschrankungen von MARENAV m TU 213 6 3 5 Beispiel f r die Weiterverarbeitung einer VSNi in einem 1 Netz C CEDE QE P Ve S 6 3 6 Hinweise zu Wiederholungsl ufe eer ENEE SE rer EE 6 3 7 Fehl
33. AVAS SYSTEM ID string Name des AVAS Systems 7 Zeichen mit dem der AVAS Benutzer arbeiten m chte U21462 J Z125 7 241 Anweisungen von AVAS QUER Dienstprogramm AVAS QUER CREATE FORMAT Format f r Ausgabedatei ausw hlen Mit der Anweisung CREATE FORMAT w hlt der Benutzer das Format f r die zu erstellen de n Ausgabedatei en aus CREATE FORMAT wird als zweite Anweisung nach SIGNON erwartet Wenn CREATE FORMAT nach SELECT OBJECT angegeben wird wird CREATE FORMAT ignoriert Wenn CREATE FORMAT nicht angegeben wird wird das LOAD2 Format verwendet CREATE FORMAT FORMAT NAME INSERT LOAD2 FORMAT NAME bestimmt in welchem Format die Ausgabedatei erstellt wird siehe Seite 238 FORMAT NAME INSERT Die Ausgabedatei enth lt die AVAS Daten in SQL INSERT Anweisungen FORMAT NAME LOAD2 Die Ausgabedatei enth lt die AVAS Daten im allgemeinen LOAD Format U21462 J Z125 7 242 Dienstprogramm AVAS QUER Anweisungen von AVAS QUER SELECT OBJECT AVAS Objekte ausw hlen Mit der Anweisung SELECT OBJECT w hlt der Benutzer die zu bearbeitenden AVAS Objekte aus Er muss die COPY ELEMENT Berechtigung f r diese Objekte besitzen Hinweis Wenn ein AVAS Element entweder durch die direkte Angabe des Namens oder durch teilqualifizierte Angaben mehrmals ausgew hlt wird wird es auch mehrmals in die Ausgabedatei geschrieben Analoges gilt f r System Parameter wenn SYSTEM PARAMS YE
34. DS 09 DS C19 DS C19 E HO2DWTE DS CL9 MITL WAIT TIME ERRORS HO2MWTE DS CL9 MAX MWAIT TIME ERRORS HO2DAZE DS Ce MITTLERE ANZAHL ERRORS DS CL250 RESERVIERT HO2ANZS DS 602 ANZAHL GESPEICHERTE ZEITEN U21462 J Z125 7 ho Po PA PA P P P P P P P P P P P P noe Aufbau der History Datei 204 Aufbau der History Datei ADR RUN WAIT TIMES RUN WAIT TIME 1 64 END RUN WAIT TIMES LAENGE SATZ H02 PLAN START RUN TIME JOB WAIT TIME ERROR 1 ANZAHL ERROR RESERVED 225 UC 64CL55 0C H02H02 HO2ARWT CL14 L9 L9 L9 L9 L3 L2 HO2ERWT Les bt er C23 eet el DS DS DS EQU ORG DS DS DS DS DS DS DS ORG 2ARWT 2ERWT 2SLEN 2PST 2AZE HO HO HO HO HO HO HO Sicherung und Reorganisation U21462 J Z125 7 Sicherung und Reorganisation KEY 03 AB VERS 6 0A H03 CHR HISTORY KEY 03 NGENFELD Aufbau der History Datei Definitionen KEY 03 TYP NET FUZN HISTORY SATZBES SATZLAE RESERVIERT AVASJRN H03 EQU NO AVASJRN H03 SATZBESCHREIBUNG
35. Die Destination DEST BA40HELIOS muss in der Datei saprfc ini der Benutzer USER AVASS in der Datei sapuser ini gepflegt sein Die LOG Datei wird im Verzeichnis c NavasNavasr3 1inkNLOG Dateien mit dem Namen BS2NTEXTPRI log angelegt Mit dem Windows Shell Kommando shi ft werden in einer Schleife alle Parameter der Datei BS EXT PRI par bernommen Zur bergabe des Programm Exit Codes an BS2000 AVAS wird das Programm avssinjv exe verwendet das unter c Programme Siemens AVAS NT Avas_sv bin installiert ist Zur bergabe der LOG Datei wird das Programm avslog exe aufgerufen das im selben Ver zeichnis installiert ist Job BS2 EXT PRI job rem Start eines R 3 Jobs aus AVAS im BS2000 0SD rem rem Die zugeh rige USER PAR FILE Datei ist BS2_EXT_PRI par rem set AVASBIN c Programme Siemens AVAS NT Avas_sv bin rem set AVASR3PATH c avas avasr3_link set AVASR3LOGFILE AVASR3PATH LOG_Dateien BS2NTEXTPRI log set RFC_INI AVASR3PATH saprfc ini rem set DEST BAOHELIOS set USER AVAS3 rem set AVASR3_CALL destination DEST user USER set AVASR3_CALL AVASR3_CALL job 2 rem Programx shift shift U21462 J Z125 7 511 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung if 21 EQU goto Endex set AVASR3_CALL AVASR3_CALL 1 2 goto Programx Endex rem Aufruf von AVASR3 mit folgenden Parametern c avas avasr3 exe AVASR3_CALL rem Auswertung der Ergebnis
36. SELECT bknet netname FROM netsymtab WHERE symdat SYMDATEI1O chen Orders wird das symbolische Datum SYMDATE1 verwendet inwe SELECT bknet netname ordername FROM ordersymtab HERE symdat SYMDATEI n welchen Jobs wird das symbolische Datum SYMDATE1 verwendet SELECT DISTINCT os bknet os netname os ordername FROM ordersymtab os ordertab o WHERE os symdat SYMDATEI AND o bknet os bknet AND o netname os netname AND o ordername os ordername AND o function J 2 In welchen Netzen wird ein bestimmtes symbolisches Datum verwendet Beispiel In welchen Netzen wird das symbolische Datum SYMDATE10 verwendet SELECT bknet netname FROM netsymtab WHERE symdat SYMDATE10 UNION SELECT bknet netname FROM ordersymtab WHERE symdat SYMDATEIO 3 An welchen Tagen ist ein bestimmtes symbolisches Datum gesetzt Beispiel An welchen Tagen ist das symbolische Datum SYM1 gesetzt SELECT calname datum FROM caldaysymtab WHERE symdat SYM1 U21462 J Z125 7 253 Datenhaltung f r AVAS QUER Dienstprogramm AVAS QUER 4 Welches Netz h ngt von einem bestimmten anderen Netz oder dem Inhalt einer be stimmten Jobvariablen ab so genannte Abh ngigkeitsstrukturen Beispiele n welchen Netzen besteht eine Abh ngigkeit vom Netz SQUER NET1 SELECT bknet netname FROM ordertab WHERE Cordername NET1 AND bkorder QUER AND typ NET AND function C n welchen Netzen besteht ein
37. Wenn der Parameter PERIOD END TIME nicht angegeben wird wird PERIOD END TIME 23 59 angenommen Protokoll der Verarbeitung F r die erzeugte Periode wird AVS8521 CREATE PERIOD period RESULT ergebnis ausgegeben oder eine Fehlermeldung Der Wert f r period ist der Name der Periode die in der Periodendatei erzeugt werden soll U21462 J Z125 7 324 BATCH Anweisungen CREATE PLAN NET CREATE PLAN NET Planung der Netzverarbeitung Mit CREATE PLAN NET sind zwei unterschiedliche Netzverarbeitungen m glich e Planung von Netzen ber den Kalender e Planung eines Netzes unabh ngig vom Kalender Wenn die BATCH Anweisung CREATE PLAN NET mit dem Parameter OPERATION PRINT abgesetzt wird werden die Netze nicht geplant sondern es wird eine Liste aller f r die Planung ausgew hlten Netze erstellt Planung von Netzen ber den Kalender Alle Netze die ber diese BATCH Funktion geplant werden sollen m ssen in der Netz beschreibung einem symbolischen Symdat oder einem realen Starttermin zugeordnet sein Bei der Planung ber den Kalender muss der Parameter PERIOD NAME angegeben werden Der Parameter RUN CONTROL SYSTEM entspricht dem Wert im Parameterfeld ALTERN RUN CONT SYS der Maske AVPO11 Die Parameter EARLIEST START und SYMDAT NAME sind nicht zugelassen Der mit CALENDAR NAME bezeichnete Kalender muss in der CALLIB vorhanden sein CREATE PLAN NET PERIOD NAME f period date time date time NET NAME S
38. 10 3 1 Programmbeispiel in Assembler Dieses Beispiel zeigt die programmtechnische Ausf hrung der Anweisungen SIGNON SUBMIT NET und END Die Fehlerbehandlung ist lediglich angedeutet EXAMPLE PROGRAM AVSASSEM AVSASSEM CSECT R EQU 1 R2 EQU 2 R3 EQU 3 R4 EQU 4 R5 EQU 5 R10 EQU 10 R13 EQU 13 R14 EQU 14 R15 EQU 15 BALR 0 USING R10 LA R13 SAVEAREA CALL AVAS SIGNON BAL R14 DELABCOM DELETE BCOM AREA MVI AVSCMDC AVSQSIGN SET CMD SIGNON MVC AVSCAUID CS USRID AVAS USER ID MVC AVSCAUPW CS USRPW AVAS USER PASSWORD MVC AVSCASID CS SYSID AVAS SYSTEM ID LA R1 PARAM L R15 V CAVASBASS BALR 8514 R15 CLI AVSRFDBI AVSQ10K BNE ERR SGN CALL AVAS SUBMIT NET BAL 814 DEL BCOM DELETE BCOM AREA MVI AVSCMDC AVSQSUNE SET CMD SUBMIT NET MVC AVSCNETN CSZNETNM OPR NET NAME MVC AVSCPERN CSZPERNM PERIOD NAME MVC AVSONECT ANZ RSLT SET MAX RESULT COUNTER U21462 J Z125 7 387 Programmschnittstelle von AVAS END DELETE BCOM AREA SET CMD END DELETE BCOM AREA BLANKS AVAS USER ID AVAS USER PASSWORD AVAS SYSTEM ID NET NAME PERIOD NAME U21462 J Z125 7 Assembler Schnittstelle LA R1 PARAM L R15 V AVASBASS BALR R14 R15 CLI AVSRFDBI AVSQ10K BNE ERR SUN SUBMIT WITH
39. 21 21 Trennzeichen zwischen zwei Parametern kennw 22 28 Kennwort f r jeden generierten Benutzer 29 29 Trennzeichen zwischen zwei Parametern bkr 30 34 Standard Benutzerkreis f r den generierten Benutzer 35 35 Trennzeichen zwischen zwei Parametern U21462 J Z125 7 2 2 4 1 48 Installation und Generierung Generierung des AVAS Systems Bezeichnung Position Beschreibung von bis futab 36 43 Name der Funktionstabelle f r den generierten Benutzer 44 44 Trennzeichen zwischen zwei Parametern k2 45 47 Berechtigung der K2 Taste f r den generierten Benutzer 48 48 Klammer zu Ende der Parameter Beschreibung einer Systemvariablen des Benutzers USVAR nnn variable 0 Bezeichnung Position Beschreibung von bis USVAR 01 08 Generierungsanweisung 09 11 Trennzeichen zwischen Anweisung und Parameter 12 12 Klammer auf Beginn der Parameter nnn 13 15 Nummer der Systemvariablen der Benutzer 16 16 Trennzeichen zwischen zwei Parametern variable 17 64 Wert der Variablen ggf in Hochkommata 18 65 Klammer zu im Bereich von bis am Ende des Parameters Beschreibung einer Funktionstabelle FUTABnnn anweisung b Bezeichnung Position Beschreibung von bis FUTABnnn 01 08 Generierungsanweisung und Nummer 09 11 Trennzeichen zwischen Anweisung und Parameter 12 12 Klammer auf Beg
40. ABLDAT NET DIRECTORY DESCRIPTION AVSDADIR DS 0CL96 ABLDAT DIRECTORY AVSDNETN DS 052 BK NETNAME PLANSTARTDATE PLANSTARTTIME AVSDNST DS X STATE 1 AVSDNST2 DS X STATE 2 AVSDNST3 DS X STATE 3 7 NET STATE SWITCH AVSDNERR DS X STATE OF ERROR AVSDNRST DS X STATE OF RESTART AVSDNCWT DS X STATE OF CONDWAIT AVSDQSON EQU X 80 0 NET STATE ON 1 NET STATE OFF AVSDNHLD DS X STATE OF HOLD AVSDNES DS 2 2200 EARLIEST STAR AVSDNESD DS CL6 EARLIEST START DATE YYMMDD AVSDNEST DS CL6 EARLIEST START TIME HHMMSS AVSDNLS DS 2 2200 LATEST START AVSDNLSD DS CL6 LATEST START DATE YYMMDD AVSDNLST DS 06 LATEST START TIME HHMMSS AVSDNTYP DS 01 ET TYPE AVSDNDSL DS X ET DELAY SOLUTION AVSDOPST 05 X OPERATOR START YES NO AVSDQSN EQU 92 NO AVSDQSY EQU 93 e YES AVSDNHTW DS X STATE OF HOSTWAIT DS CL29 RESERVED DS 0C 390 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Schnittstelle Erl uterung der Status Anzeigen 0511 X Aktueller Verarbeitungsstatus des Netzes in der Ablaufdatei Die Bedeutung der Schl sselw rter ist bei den Dialogfunktionen beschrieben siehe Anwei sung SHOW NET STATUS usw X 14 ABENDED X 15 ENDED X 16 ERROR X 17 HOLD X 18 RUNNING X 19 WAITING X lA CONDWAIT X 1B RESTARTED X 1C RESUMED X 3D OPWAIT X 3F IGNORED X 44 START X 9A SHIFTED X AD HOSTWAIT NST2 X Geforderte Aktion einer Dialogfunktion auch
41. Alle neuen Eintr ge m ssen gem PLAN START eingef gt werden weil zum L schen von Eintr gen sonst der PLAN START von allen Eintr gen gepr ft werden muss um jeweils den Eintrag mit dem kleinsten PLAN START zu ermitteln Satzaufbau der HISTORY Datens tze Definitionen KEY 01 TYP SUM FU N HO AVASJRN H01 dee ek dee ke ehe e he khe he ehe ee he hee he he hee he he e he eck ee he ehe dee ee he eck e ke SATZBESCHREIBUNG HISTORY KEY 01 AB VERS 6 0A H01 001801 DS OF SATZBESCHR HISTORY KEY 01 HOISLEN DS H SATZLAENGENFELD DS H RESERVIERT HKY AVASJRN HO1 EQU NO SATZBESCHREIBUNG HISTORY ISAM SCHLUESSEL AB VERS 6 0A
42. Das AVAS Tabellenheft 3 enth lt eine bersicht der Anweisungen und Parameter sowie eine grafische Darstellung der Maskenfolgen und Operationscodes Es gibt eine bersicht ber die Dialogf hrung beim Restart die Netzstatus die Status der Bedingungseintr ge sowie der Protokollstatus Au erdem sind alle Meldungen des AVAS Systems aufgef hrt 4 U21462 J Z125 7 Einleitung Readme Datei 1 5 Readme Datei Funktionelle Anderungen und Nachtr ge der aktuellen Produktversion zu diesem Hand buch entnehmen Sie bitte ggf der produktspezifischen Readme Datei Die Readme Datei finden Sie auf Ihrem BS2000 Rechner unter dem Dateinamen SYSRME produkt version sprache Die Benutzerkennung unter der sich die Readme Datei befindet erfragen Sie bitte bei Ihrer zust ndigen Systembetreuung Der vollst ndige Pfadname wird auch durch folgendes Kommando ausgegeben SHOW INSTALLATION PATH INSTALLATION UNIT AVAS LOGICAL IDENTIFIER SYSRME D Sie k nnen die Readme Datei am Bildschirm mit dem Kommando SHOW FILE oder einem Editor ansehen oder auf einem Standarddrucker mit folgendem Kommando ausdrucken PRINT DOCUMENT FROM FILE SYSRME produkt version sprache LINE SPACING BY EBCDIC CONTROL U21462 J Z125 7 5 Anderungen gegen ber der vorigen Handbuchausgabe Einleitung 1 6 nderungen gegen ber der vorigen Handbuchausgabe Die AVAS Version V7 0A enth lt gegen ber der Vorg ngerversion V6 0A folgende wesent liche Anderu
43. Die Namen der Dateien auf die zugegriffen wird sind in den System Parametern definiert Die Dateizuweisungen f r diese Dateien werden von den Zugriffsprozessen abgesetzt Die PLAM ZD und die UPAM ZD werden mit folgenden Prozeduren Elemente J der Bib liothek SYSENT AVAS 070 gestartet 1 AVS ZDPLAM 2 AVS ZDUPAM Die zentralen Zugriffsprozesse steuern die Zugriffe auf die AVAS Bibliotheken PLAM ZD und auf die Ablaufdatei und die Journalda tei UPAM ZD Beim Start der Zugriffsprozesse k nnen folgende Anweisungen ber SYSDTA mitgegeben werden Anweisungen UPAM ZD PLAM ZD ABLCOPY ja nein ABLDUP ja nein CENTRAL PASSWORD ja ja ENCRYPTION CODE nein ja MAX SERIAL LOCK ja nein MAX SERIAL WAIT ja nein RCS PASSWORD ja ja REO PASSWORD ja ja U21462 J Z125 7 107 Starten und Beenden der AVAS Prozesse Administration von AVAS ABLCOPY YES Vor dem Start der UPAM ZD soll ein Duplikat ABLDUP der Ablauf datei ABLDAT erzeugt werden NO Ein Duplikat der Ablaufdatei soll nicht erzeugt werden Wenn ABLCOPY nicht angegeben wird wird ABLCOPY NO angenommen Die Anweisung ABLCOPY YES wird nur ausgef hrt wenn auch ABLDUP YES ange geben wird ABLDUP YES Ein Duplikat der Ablaufdatei soll mitgef hrt werden Alle Ausgaben werden in die Ablaufdatei ABLDAT und in das Duplikat ABLDUP geschrieben NO Ein Duplikat der Ablaufdatei wird nicht mitgef hrt Wenn ABLDUP nicht
44. Die Unterst tzung von Programmen zur Datensicherung durch MAREN Die Unterst tzung von Archivsystemen durch MAREN Bestellnummer U2106 J Z125 9 12 MAREN V10 0A BS2000 OSD Band 2 Benutzerschnittstellen Benutzerhandbuch Zielgruppe Das Handbuch wendet sich an alle BS2000 Anwender RZ Organisatoren Operatoren und Systembetreuer Inhalt Band 2 enth lt bersichten Schnittstellenbeschreibungen und Beispiele zur Arbeit mit MAREN aufgeteilt in einen privilegierten und einen nichtprivilegierten Teil m privilegierten Teil werden die Verwaltung von MAREN mit MARENADM die Konfigu ration und Installation von MAREN die Erstellung und Migration des MAREN Katalogs sowie die Fehlerbehandlung beschrieben Im nichtprivilegierten Teil werden die MAREN Kommandos und das Benutzerpro gramm MAREN beschrieben Der Anhang enth lt u a die Meldungsausgaben und globale Parameter Bestellnummer U4146 J Z125 8 U21462 J Z125 7 543 SDF V4 5A BS2000 OSD Einf hrung in die Dialogschnittstelle SDF Benutzerhandbuch Zielgruppe BS2000 OSD Anwender Inhalt Das Handbuch beschreibt die Dialog Eingabe von Kommandos und Anweisungen im SDF Format Ein Schnelleinstieg mit leicht nachvollziehbaren Beispielen und weitere umfangrei che Beispiele erleichtern die Anwendung SDF Syntaxdateien werden erkl rt Bestellnummer U2339 J Z125 8 SDF V4 5A BS2000 OSD SDF Verwaltung Benutzerhandbuch Zielgruppe Das Handbuch
45. Die Zugriffsprozesse werden durch Setzen des Strings SHUTDOWN in die entsprechende Jobvariable veranlasst die Beendigung durchzuf hren siehe Seite 128 Der Name der Jobvariablen ist in den System Parametern eingetragen Die Zugriffsprozesse f r die Journal und Ablaufdatei sowie f r die Bibliotheken werden nur beendet wenn keine Benutzer oder Ablaufkontrollprozesse mehr aktiv sind Wenn noch Partner Prozesse aktiv sind wird die Beendigung der Zugriffsprozesse bis nach Beendigung aller Partner Prozesse verz gert Abnormales Beenden der Zugriffsprozesse Wenn im Zugriffsprozess ein nicht behebbarer Prozessfehler auftritt Programmfehler Makrofehler usw wird der Prozess nach Ausgabe eines Speicherauszugs und einer Feh lermeldung beendet Wenn m glich werden betroffene Partnerprozesse ber die abnor male Beendigung informiert Wenn bei abnormaler Beendigung Dateien nicht ordnungsgem geschlossen werden k nnen z B Stromausfall m ssen f r die betroffenen Dateien die BS2000 Kommandos REPAIR DISK FILES und REMOVE FILE ALLOCATION LOCKS abgesetzt werden Die Ablaufdatei und die Journaldatei k nnen sonst beim n chsten Start der Prozesse zerst rt werden Bei einem nicht behebbaren ILAM Fehler in Bezug auf eine Bibliothek wird nach Ausgabe eines Speicherauszugs und einer Fehlermeldung diese Bibliothek f r weitere Zugriffe gesperrt 112 U21462 J Z125 7 Administration von AVAS Starten und Beenden der AVAS Prozess
46. Netzdaten ABLDAT E2 Satz Daten Strukturelement ABLDAT E3 Satz Daten Strukturelement mit FUZC und TYPE JVA Daten der Restart Punkte Netzdaten MOD SUBM NET Parameter f r BS2000 Job S Prozedur Server Job Daten Strukturelement mit FUZC A M D W Daten Restart P O E P O R Daten Strukturelement mit FUZS JCL Anweisung 01 08 09 11 12 14 15 16 21 22 23 25 31 32 51 52 53 54 55 56 57 58 59 65 U21462 J Z125 7 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Satzfolgenummer Die Satzfolgenummer beschreibt den Zustand der ausgegebenen Daten Sie beschreibt ob es sich um Eingabe oder Ausgabedaten oder um Daten vor oder nach einer Anderung handelt FNR 00 Start der Aktion oder Durchf hrung 01 vorhandene Daten INPUT 02 erstellte ge nderte Daten OUTPUT 03 Unterbrechung CONDWAIT oder HOSTWAIT 04 L schen von Daten 05 Fehler vorhandene Daten INPUT 06 Fehler erstellte ge nderte Daten OUTPUT 07 Ende der Aktion C S oder E 08 Abbruch der Aktion I R oder Fehler 09 Fehlermeldung zum Satzschl ssel Text 190 U21462 J Z125 7 Sicherung und Reorganisation Datenstrukturen Journalsicherung Not Journaldatei Journals tze der Anweisungen Nachfolgend sind die Journals tze zusammengestellt die von den einzelnen Anweisungen ausgegeben werden Zu beachten ist dass bei einer Verarbeitung jeweils nur eine Unter menge der aufgef hrte
47. bergeben siehe Abschnitt Starten und Beenden der Ablaufsteuerung auf Seite 113 Vor dem Starten eines Server Jobs wird von der Ablaufsteuerung die Verf gbarkeit des Servers berpr ft F r jeden Server der in der Konfigurationsdatei beschrieben wird ist unter der BS2000 Kennung der Ablaufsteuerung eine Jobvariable mit dem Namensschema AVS SERVER STATE lt server jv link name gt lt server name gt anzulegen Diese Server Jobvariable dient zur Kontrolle der Betriebsbereitschaft eines Servers Sie wird eingerichtet und verwaltet wie eine Jobvariable zur berwachung des Verbundstatus eines MSCF Teil nehmers beim MSCF Verbund unter BS2000 OSD Belegung und Inhalt der Server Jobvariable ist im Abschnitt Prozess Server berwachung auf Seite 486 beschrieben Folgende Status Werte f r einen Server Job setzt die Ablaufsteuerung in Abh ngigkeit von den beiden ersten Stellen der AVS SERVER Jobvariablen HOSTWAIT Der Server ist nicht verf gbar ERROR wenn die Server Jobvariable AVS SERVER STATE lt server jv link name gt lt server name gt nicht gele sen werden kann in diesem Fall kann der Server Job nicht zum Ablauf ge bracht werden Mit der Auftrags Jobvariablen f r AVSSINCM kann die Ablaufsteuerung nur AVSSINCM direkt berwachen Deswegen ist ein Bereich der Auftrags Jobvariablen f r den Status des Server Jobs SV Status reserviert den AVSSINCM aktualisiert U21462 J Z125 7 455 Ablaufsteuerung kon
48. 3 zusammengestellt 345 U21462 J Z125 7 Fehlerinformation bei den BATCH Funktionen BATCH Funktionen 346 U21462 J Z125 7 9 Externe Erstellung von AVAS Elementen Netze BS2000 Jobs S Prozeduren Server Jobs JCL Bausteine und Dokumentationen f r die AVAS Netze k nnen auch au erhalb von AVAS erstellt werden Sie k nnen mit der Anweisung COPY ELEMENT in die AVAS Bibliotheken NETLIB JCLLIB und DOCLIB ein gelesen werden F r die externe programmtechnische Erstellung von Netzen stehen die Makrodefinitionen der Datens tze in der NETLIB zur Verf gung Die extern erstellten Netze werden beim Einlesen in die AVAS Bibliothek ber die CHECK Funktionen gepr ft Bei Fehlern wird ein Protokoll der Pr fung ausgegeben 9 1 Externe programmtechnische Erstellung von Netzen Mit dem Makro AVASNET k nnen Netze in einer externen Bibliothek durch Benutzer programme erzeugt werden Anschlie end k nnen die Netze mit der Anweisung COPY ELEMENT in eine AVAS Netzbibliothek eingelesen werden Damit ist eine externe programmtechnische Erstellung von Netzen m glich Der Makro AVASNET wird in der SYSLIB AVAS 070 ausgeliefert Der Makro AVASNET beschreibt die Datenstrukturen der Netze in den AVAS Netzbiblio theken NETLIB Die zugelassenen Werte f r die vorhandenen Parameter sind bei der Anweisung CREATE NET DESCRIPTION beschrieben Wenn Parameter in Form von Schl sseln gespeichert werden sind diese im Makro definiert Jed
49. C3LMIN C3L U21462 J Z125 7 Externe Erstellung von AVAS Elementen IL U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen AVASNET RECORD A3 PREFIX N MFCHK MF C PREFIX N MACID A3 DMACID A3D SUPPORT C D DS OF IHHHHE PREFIX N MACID2A3 HH DS OF DS H PLAM RECORD LENGTH DS C PLAM RESERVED PLAM SK DS C PLAM RESERVED PLAM SA DS CL2 RECORD KEY DS C DESCRIPTION FUNCTION CODE DS X DESCRIPTION TYPE CODE DS CL RESERVED DS CL3 INDEX DS CL30 AME DS CL2 RESERVED PARAMETERS FUNCTION A TYPE RES VAL M RES VAL DS CL128 VALUE DS XL1 VALUE CODE DESCRIPTION TYPE RES DESCRIPTION FUNCTION A M gt MEANING EQU 11 I CREATED EQU 22 ERROR EQU 107 FREE EQU 118 SHARE EQU 119 EXCLUSIVE USED NOT USED DS CL3 RESERVED EQU NA3A RECORD LENGTH MINIMUM DS OF NA3A A3A A3SLEN A3SSL A3FUNC A3TYPE A3IND A3NAM Hr E r NASAVAL NA3AVCO NA3ECRE NASEERR NA3EFRE NA3EUSH NA3EUEX NA3LMIN NA3L Externe programmtechnische Erstellung von Netzen Externe Erstellung von AVAS Elementen AVASNET RECORD M3 PREFIX N MFCHK MF C C PREFIX N 6 MACID M3 C DMACID M3D C SUPPORT C D DS OF IHHHHE PREFIX N MACID M3 HHHHE DS OF DS H PLAM RECORD LENGTH
50. DS C PLAM RESERVED PLAM SK DS C PLAM RESERVED PLAM SA DS CL2 RECORD KEY DS C DESCRIPTION FUNCTION CODE DS X DESCRIPTION TYPE CODE DS CL RESERVED DS CL3 INDEX DS CL30 AME DS CL2 RESERVED de PARAMETERS FUNCTION A TYPE RES VAL M RES VAL DS CL128 VALUE DS XL1 VALUE CODE DESCRIPTION TYPE RES DESCRIPTION FUNCTION A M gt MEANING EQU 11 I CREATED EQU 22 ERROR EQU 107 FREE EQU 118 SHARE EQU 119 EXCLUSIVE USED NOT USED DS CL3 RESERVED EQU NM3A RECORD LENGTH MINIMUM DS OF NM3A 369 M3A 3SLEN M3SSL 3FUNC 3TYPE 3IND 3NAM Hr E e NM3AVAL NM3AVCO NM3ECRE NM3EERR NM3EFRE NM3EUSH NM3EUEX NM3LMIN NM3L U21462 J Z125 7 Externe Erstellung von AVAS Elementen IL JHHHHE PREFIX N MACID D3 HHH PLAM RECORD LENGTH PLAM RESERVED PLAM SK PLAM RESERVED PLAM SA RECORD KEY DESCRIPTION FUNCTION CODE DESCRIPTION TYPE CODE RESERVED INDEX AME RESERVED TYPE TI TYPE NET JOB RES VAL RESERVED RECORD LENGTH MINIMUM U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen AVASNET RECORD D3 PREFIX N MFCHK MF C PREFIX N MACID D3 DMACID D3D SUPPORT C D DS OF DS OF DS H DS C DS C DS CL2 DS C DS X DS
51. DS H RESERVIERT HKY AVASJRN H02 EQU NO SATZBESCHREIBUNG HISTORY ISAM SCHLUESSEL AB VERS 6 0A HO2KEY DS 602 SATZSCHLUESSEL 02 HO2BKR DS CL5 BENUTZERKREIS HO2NETN DS CL12 NET NAME HO2DTPL DS OCL PLAN DATUM JHYYMMTT HO2DTJH DS 602 JAHRHUNDERT JH HO2PLSD DS Ce PLAN START DATE YYMMTT HO2PLST DS Cp PLAN START TIME HHMISS HO2SYMD DS CL20 SYMDAT NAME HO2IND DS 3 INDEX HO2JOBN DS CL30 JOB NAME HOPFUNK DS FU N J P X HO2STYP DS 603 TYP SUM NET JOB HO2KLEN EQU HO2KEY KEYLE HO2HLEN EQU H02H02 LAENGE HEADER DS CLIO RESERVIERT HO2LSTT DS 09 LAST START TIME HO2LRNT DS CL9 LAST RUN TIME HO2LENT DS 09 LAST END TIME HO2ANZA DS CL4 ANZAHL ABLAEUFE HO2DURT DS 609 MITL RUN TIME HO2MART DS CL9 MAX RUN TIME HO2MIRT DS CL9 MIN RUN TIME HO2RANG DS 09 RANGE HO2STDA DS 609 STANDARDABWE I CHUNG DS CL9
52. FUNCTION C TYPE RES ORG AVSNVANF U21462 J Z125 7 395 Assembler Schnittstelle Programmschnittstelle von AVAS AVSNCROC DS 12XL1 OCCURE VALUE CODE KEYWORD AVSNCREC DS 12XL1 ERROR VALUE CODE KEYWORD FUNCTION C TYPE VAL ORG AVSNVANF AVSNCVOS DS CL128 OCCURE VALUE STRING AVSNCVES DS CL128 ERROR VALUE STRING FUNCTION W TYPE TIM ORG AVSNVANF FUNCTION A TYPE RES ORG AVSNVANF AVSNARVC DS XL1 VALUE CODE FUNCTION A TYPE VAL ORG AVSNVANF AVSNAVVA DS CL128 VALUE FUNCTION M TYPE RES ORG AVSNVANF AVSNMRVC DS vu VALUE CODE FUNCTION M TYPE VAL ORG AVSNVANF AVSNMVVA DS CL128 VALUE FUNCTION D TYPE RE TYPE VAL ORG AVSNVANF FUNCTION D TYPE NET ORG AVSNVANF AVSNDNCN DS CL32 COND DESCR CREATED BY NET NAME FUNCTION D TYPE JOB ORG AVSNVANF AVSNDJCN DS 052 COND DESCR CREATED BY NET NAME AVSNDJCI DS CL3 COND DESCR CREATED BY INDEX FUNCTION J TYPE STD TYPE MOD TYPE EX FUNCTION P TYPE STD TYPE MOD TYPE EX 396 U21462 J Z125 7 Assembler Schnittstelle Programmschnittstelle von AVAS TYPE EXX FUNCTION X TY
53. INCLUDE MARENAV Cavas systembibliothek USW U21462 J Z125 7 77 RZ Exits im AVAS System Installation und Generierung 2 4 4 Verst ndigung zwischen AVAS System und RZ Routinen Die Verst ndigung zwischen dem AVAS System und den RZ Routinen erfolgt in beiden Richtungen ber Datenbereiche die AVAS zur Verf gung stellt und die von den RZ Routi nen nachgebildet werden k nnen Es wird unterschieden zwischen Verst ndigungs und Kommunikationsbereich Den Ver st ndigungsbereich haben alle RZ Routinen gemeinsam Jede RZ Routine hat aber ihren eigenen Kommunikationsbereich 2 4 4 1 Verst ndigungsbereich Der Verst ndigungsbereich besteht aus Feldern in denen AVAS den RZ Routinen allge meine Informationen bergibt Dies sind e die BS2000 TSN e der Name der AVAS SYSTEM ID e der AVAS Benutzername e der AVAS Benutzerkreis e der Name des AVAS Ablaufsteuerungssystems e derKalendername e die L nge des Verst ndigungsbereichs Die RZ Routine bergibt im Feld RETURNCODE den Funktionscode an AVAS Diese Codes sind bei den einzelnen RZ Exits beschrieben Die Feldbeschreibungen k nnen mit dem Makro AVASEXKO Makrobibliothek SYSLIB AVAS 070 erstellt werden Eine DSECT Anweisung muss der Benutzer selbst davor setzen Der Aufruf hat folgendes Format name AVASEXKO EXITNAM USINFOL PFIX pfix wobei pfix ein maximal 3 stelliger Pr fix sein kann 78 U21462 J Z125 7 RZ Exits im AVAS System
54. J3IND J3NAM HH 0X Ro Ro Xx FIELDS DES AND ob ox ox NJ3LMIN NJ3JFIL Externe programmtechnische Erstellung von Netzen 364 Externe programmtechnische Erstellung von Netzen SERVER FILENAME NAME OF USER PAR FILE TYPE OF USER PAR FILE LIB SAM SA LIB STD NONE RESERVED SERVER NAME PASSWORD OF ENTER FILE PASSWORD OF SERVER NAME RESERVED 365 Externe Erstellung von AVAS Elementen 0CL54 CL54 RS Ch Cx CL8 0CL11 CLII OF NJ3A DS DS DS EQU EQU EQU EQU DS DS DS DS DS DS EQU J3SXID J3FPS J3SXP J3L U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen Externe Erstellung von AVAS Elementen AVASNET RECORD C3 PREFIX N MFCHK MF C C PREFIX N 0 MACID C3 0 DMACID C3D C SUPPORT C D DS Op AHHHHE PREFIX N MACID C3 HHHHE C3A DS Op C3SLEN DS H PLAM RECORD LENGTH DS PLAM RESERVED PLAM SK DS C PLAM RESERVED PLAM SA 603550 DS CL RECORD KEY C3FUNC DS DESCRIPTION FUNCTION CODE C3TYPE DS X DESCRIPTION TYPE CODE D CET RESERVED C3IND DS 603 INDEX C3NAM DS CL30 AME DS LS RESERVED S PARAMETERS x FUNCTION C TYPE JVA NET JOB RES VAL A C3CVAL DS 6 0200 COND VALUE C3COST DS CL128 OCCURE VALUE STRING C3CEST DS CL128 ERROR VALUE STRING C3COCO DS 12XL
55. Konfigurationsdatei ber die Konfigurationsdatei wird dem symbolischen Namen einer Verbindung zu einem Server Rechner SERVER NAME eine reale Verbindung zwischen dem BS2000 Rechner und einem Server Rechner zugeordnet LATEST START Sp teste Startzeit des Netzes oder eines Auftrages im Netz LIFE TIME Zeitspanne bzgl PLAN START gibt an wie lange das Ereignis Netz Ende oder Job Ende g ltig und erkennbar bleiben soll LOG Parameter f r den ENTER Aufruf des Jobs der S Prozedur oder des AVAS Agenten AVSSINCM LOGSYS Linkname f r die zentrale Bibliothek der Job Ablaufprotokolle AVAS Pool M Markierungsspalte in den AVAS Systemmasken zur Auswahl von Elementen NET ACCOUNT Standardwert f r JOB ACCOUNT NET CAT Katalogkennung eines SLAVE Rechners oder Servername eines entfernten Rechners NET CLASS Standardwert f r JOB CLASS NET DELAY SOLUTION Ma nahme f r nicht zeitgerechten Netzstart U21462 J Z125 7 533 NET DOC Name des Dokumentationselements zu einem Netz NETLIB Linkname f r die Bibliothek der Netzbeschreibungen NETMAP Linkname f r die Bibliothek der Benutzermasken bzgl Netze NETSYS Linkname f r die zentrale Bibliothek der Netzbeschreibungen NET LOG Standardwert f r LOG NET NAME Name des Netzes NET PARAMETER Standardwert f r JOB PARAMETER NET STATUS Status Indikator des Netzes NET TEXT Kurzbezeichnung des Netzes NET TYPE Steuergr e zur Serialisierung der Verarbeitung mehr
56. REPORT LINK angegeben wird dann wird gesetzt OUT OF PLAN OUTPUT REPORT FILE LST AVAS OOP jjmmtt hhmmss PLANNED NET MODIFICATION OUTPUT REPORT FILEZLST AVAS PNM jjmmtt hhmmss 292 U21462 J Z125 7 REPORT Anweisungen OUTPUT REPORT LINK OUTPUT REPORT LINK Zuordnen einer Reportdatei ber Kettungsname Mit OUTPUT REPORT LINK wird der Reportdatei ein BS2000 Dateikettungsname zuge ordnet Diese Datei ist die Ausgabedatei f r den zu druckenden Report Die Anweisung muss nur bei FUNKTIONZPRINT angegeben werden OUTPUT REPORT LINK full filename Kettungsname gem den BS2000 Konventionen Die ber die Anweisung zugeordnete Reportdatei wird vom REPORT Generator im Modus OUTPUT EXTEND er ffnet wenn sie bereits vorhanden ist Der REPORT Generator sammelt die Daten der Reports in der angegebenen Reportdatei wenn FUNKTION PRINT mehrfach mit der gleichen Dateizuweisung aufgerufen wird Damit k nnen unterschiedliche Auswertungen einer Arbeitsdatei ber die REPORT Anwei sungen SELECT STATUS und THRESHOLD in eine Reportdatei ausgegeben werden und aus dieser mit dem BS2000 Kommando PRINT FILE gedruckt werden Das Ausgabeformat ist druckaufbereitet Parameter CONTROL CHARACTERS EBCDIC Wenn eine neue Reportdatei angelegt werden soll muss eine u U vorhandene Reportdatei vorher gel scht werden Die Anweisung OUTPUT REPORT LINK kann alternativ zur Anweisung OUTPUT REPORT FILE angegeben werden Der Kettungsname muss ber da
57. U21462 J Z125 7 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung PORT integer 1025 65535 NONE TCP Port unter dem AVSSVDOG von AVSSURF kontak tiert werden kann Vorgabewert NONE INITIAL TIMEOUT integer 1 60 gt Wartezeit in Sekunden auf Antwort des Servers bei der ersten Kontaktaufnahme Start des AVSSVDOG Die War tezeit gilt f r jeden einzelnen Kommunikationsschritt Vorgabewert 1 Sekunde TIMEOUT integer 1 60 gt Wartezeit in Sekunden auf Antwort des Servers bei Ser ver Kontaktierungen nach der ersten Kontaktaufnahme Vorgabewert 10 Sekunden Hinweis Beim Starten des AVAS Systems d rfen die Ablaufsteuerungen erst starten wenn die Server berwachung die SV JVs auf den aktuellen Stand gebracht hat Status READY in der die Server berwachung kontrollierenden Jobvariablen Beenden der Server berwachung Die Server berwachung wird durch die Operation SHUTDOWN beendet Die Eingabe erfolgt ber MODIFY JV JV IDENT JV NAME jvname SHUTDOWN ab der ersten Stelle der berwachenden Jobvariablen 490 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs Operation zur Aktualisierung der Serverumgebung Die Aktualisierung erfolgt ber Eingaben ab der ersten Stelle in die berwachende Jobva riable MODIFY JV JV IDENT JV NAME Cjvname VALUE C CONFIG Die Operation lautet CONFIG Die Ko
58. U21462 J Z125 7 server name 30 454 459 9 SERVER PROCEDURE NAME 119 SERVER PROCEDURE PASSWORD 120 server pw 454 459 519 Server System Ablaufsteuerung 441 442 443 AVSREC starten 522 Startparameter 119 Server berwachung 121 beenden 126 Eingabeparameter 124 Funktionen 122 488 starten 124 Zyklische berpr fung 123 488 Server berwachung Prozess 104 131 486 Serverumgebung aktualisieren 132 Sicherheit im AVAS System 104 sichern Journals tze 183 Protokolldaten 186 Protokolleintr ge 186 SIGNAL Programm 137 beenden 147 starten 144 SIGNON BATCH Anweisung 342 Programmschnittstelle 373 SIGNON AVAS QUER Anweisung 241 Software Abh ngigkeiten f r AVAS QUER 257 Software Voraussetzungen AVAS DOORS 64 AVAS QUER 257 Sortierkriterien OOP Report 282 speichern Protokoll 7 Standardparameter AVS DEF COMM PASSW 467 AVS DEF DIRECTORY 467 AVS DEF HOST NAME 467 AVS DEF PART PASSW 467 AVS DEF PORT NUMBER 7 AVS DEF SERVER VERS 467 AVS DEF USER ID 467 U21462 J Z125 7 Stichw rter RZ Routinen anschlie en 76 in AVAS einbinden 74 in Verarbeitung einbringen 68 Verst ndigungsbereich 78 5 5 44 Satzbeschreibung NETLIB 7 Satzschl ssel Journal 189 Schl ssel f r AVSCMDC definieren 1 f r AVSRELTC definieren 1 Schl sselwort AVAK 35 FUTABnnn 33 JOB MAP 32 NET MAP 33 NET PRO 32 PRODTABnnn 32 USER 31 SELECT OBJECT AVAS QUER Anweisung 243 SELECT TURNUS 536 Serialisieru
59. Wenn der Parameter nicht angegeben wird erfolgt die Meldungs ausgabe nur nach SYSOUT Einschr nkung Die Einstellung gilt nur f r den AVAS Dialog ab einer erfolgreichen Anmeldung Die Standardeinstellung ist bis zu einer erfolgreichen Anmeldung wirksam MAX CENTRAL PROCESS n Maximale Anzahl von CENTRAL Prozessen die gleichzeitig laufen k nnen F r n darf maximal 30 angegeben werden Standardwert ist 4 Die Anzahl gilt nur f r Sekund rtasks CALLIB dateiname Dateiname der Kalender Bibliothek PERDAT dateiname Dateiname der Perioden Datei ISAM Datei Dateinamen der zu benutzenden Bibliotheken Die Namen dateiname der folgenden AVAS Bibliotheken k nnen mit der Anweisung MODIFY SYSTEM PARAMS nicht ge ndert werden Im laufenden Betrieb kann jedoch einem Benutzerkreis und damit einem Benutzer ber ein in der Generierungsdatei definier tes Schl sselwort eine andere Datei zugeordnet werden Die Nummern nnn 000 999 in den Schl sselw rtern z B NETnnn m ssen nicht l ckenlos sein Sie werden allgemein mit LIB bezeichnet z B NETLIB Mit dateiname wird der Name einer PLAM Bibliothek definiert 24 U21462 J Z125 7 Generierung des AVAS Systems Dateiname der Systembibliothek in der die systemweit f r alle Benutzer verf gbaren Netzbeschreibungen gespeichert werden Dateiname der Benutzerbibliotheken in denen die Netz beschreibungen der Benutzer gespeichert werden Dateiname der Systembibliothek in
60. Wenn einem Benutzerkreis andere NETnnn oder und JCLnnn Bibliotheken zugeord net werden verliert er den Zugriff auf die Elemente in den bisher benutzten Bibliothe ken Mit der Namens nderung von calendar und oder avak kann einem Benutzerkreis ein anderer Kalender und oder eine andere Ablaufsteuerung zugeordnet werden Definieren eines neuen Benutzerkreises BK Neue Benutzerkreise k nnen nach dem Start der Zugriffsprozesse mit den ge nderten System Parametern ohne Einschr nkungen genutzt werden USER Die Definitionen der Benutzer k nnen ohne Einschr nkungen ge ndert werden neue Benutzer k nnen definiert werden Wenn der dem Benutzer zugeordnete Benutzerkreis ge ndert wird verliert der Benut zer den Zugriff auf die Elemente seines alten Benutzerkreises wenn er nicht privilegiert ist und dem neuen Benutzerkreis andere Bibliotheken zugeordnet sind Produktionspl ne und Maskenbibliotheken Die Definition neuer Produktionspl ne und Maskenbibliotheken ist ohne Einschr nkun gen m glich Wenn die Zuordnung von Bibliotheken ge ndert wird geht der Zugriff auf die alten Bibliotheken und die darin enthaltenen Elemente verloren Funktionsberechtigungen Die Tabellen mit den Funktionsberechtigungen k nnen ohne Einschr nkungen ge n dert werden Neue Tabellen k nnen eingerichtet und den Benutzern zugeordnet werden 46 U21462 J Z125 7 Installation und Generierung Generierung des AVAS Systems Andern der Ablaufste
61. bergeben U21462 J Z125 7 def name def name CAVSCPERN CAVSCNETN CAVSCRCSN CAVSCNETN CAVSCSYDN AVSCEAS CAVSCNETN CAVSCPERN CAVSCCALN AVSCUSPF CAVSCCDNM CAVSCCDNT CAVSCCDNN CAVSCLTI CAVSCCDVL CAVSCCDNM CAVSCCDNT CAVSCCDNN CAVSCCDNI CAVSCLTI CAVSCCDVL CAVSCCDNM CAVSCCDNT CAVSCCDVL Anweisungen der AVAS Programmschnittstelle anweisungsname operand wert operand wert def name beschreibt den Namen der f r die Programmschnittstelle in den Definitionen verwendet wird CREATE PLAN NET PERIOD NAME ET NAME LRUN CONTROL SYSTEM CREATE PLAN NET ET NAME SYMDAT NAME 1 EARLIEST START CREATE PROD NET ET NAME PERIOD NAME CALENDAR NAME USER PAR FILE MODIFY COND DESCRIPTION CONDITION NAME CONDITION TYPE NET LCREATED BY NET 2 1 LLIFE TIME LCONDITION VALUE MODIFY COND DESCRIPTION ON NAME ON TYPE ED BY NET ED BY INDEX d U TIME TION VAL DIT DIT EAT EAT FE D CON CON LER LER CLI CO MODIFY COND DESCRIPTION ON NAME ON TYPE RES ON VALUE DIT DIT CON CON DIT CON 374 Anweisungen der AVAS Programmschnittstelle CAVSCCDNM CAVSCCDNT CAVSCCDVL AVSCUSLB CAVSCNET CAVSCPER AVSCRCS AVSCU AVSC AVSC AVSC AVSC 2 U Co Co m rmn Co Ina lt AVSCUSLB
62. bersicht 312 BATCH Betrieb optimieren 158 548 Stichw rter Dateikettungsname AVASSYS f r Datei SYSPAR 107 Dateiname Ablaufdatei 26 History Datei 26 Journaldatei 26 Datenbank AVAS QUER 231 Datenbereich Identifikation 188 Datenhaltung AVAS QUER 246 Datensammlung Protokoll 138 Datenstationstyp falsch in PDN 67 Datentr gerlisten erstellen 267 Datentr gerpr fungen durchf hren 259 Datum variables in Periode 2 Definition Ablaufsteuerung 35 Benutzer 30 Benutzerkreis 27 29 Funktionsberechtigung 33 Funktionssteuerung 43 Perioden ber BATCH Anweisung 320 Produktionspl ne 32 Standardwerte f r Jobbearbeitung 40 Standardwerte f r Netzbeschreibung 38 Standardwerte f r Netzfreigabe 42 Standardwerte f r Netzplanung 39 Standardwerte f r Strukturanzeige von Netzen 40 Standardwerte f r bersichtsverarbeitung 38 Systemvariable der Benutzer 34 Werte f r Restart Verarbeitung 42 Zuordnung Maskenbibliotheken zu Jobbibliotheken 32 Zuordnung Maskenbibliotheken zu Netzbibliotheken 33 Zuordnung Netzbibliotheken zu Produktionspl nen 32 deinstallieren AVAS R3JobControl UNIX 450 AVAS SV BS2000 453 AVAS SV UNIX 450 AVAS SV Windows 452 DELAY SOLUTION 529 549 C calendar 29 CALLIB 24 54 163 528 CANCEL AVSSTHT 517 Server Job 517 CANCEL NET BATCH Anweisung 315 CENTRAL Prozess beenden 143 starten 141 CHANGE NET DESCRIPTION BATCH Anweisung 316 CLIENT Parameter f r R 3 7 CNTAPC 465 CNTAPP 465 CO
63. kolle der Status ERROR zugeordnet Wenn mehrere Protokolle mit unterschiedlicher TRANSFER OPTION signalisiert werden f hrt eine Angabe von ENDED oder ERROR immer zum Start des TRANSFER Folgejobs In diesem Fall werden alle Protokolle mit Status ASSIGNED vom TRANSFER Programm behandelt DELETE YES NO Der Parameter DELETE ist bei SIGNAL nur dann anzugeben wenn mehrere Protokolle signalisiert werden und de Dateien nach fehlerfreier bertragung unterschiedlich behandelt werden sollen und TRANSFER in einem Folgejob durch die Ablaufsteuerung auf gerufen wird Die Dateien werden durch TRANSFER gel scht YES Die Datei soll nach fehlerfreier Speicherung gel scht werden NO Die Datei bleibt unter der erstellten Benutzerkennung erhalten Hinweis Wenn der Parameter DELETE nicht angegeben wird wird der beim Start von CENTRAL angegebene Wert angenommen Der so gesetzte Wert kann durch eine Vorgabe bei TRANSFER noch ge ndert werden Beenden des SIGNAL Programms Das SIGNAL Programm beendet sich nachdem alle Informationen an den CENTRAL Prozess gesendet wurden Wenn w hrend des SIGNAL Vorgangs Fehler auftreten z B falsche Parameter vorgege ben CENTRAL Prozess nicht verf gbar usw wird eine Meldung ausgegeben Wenn beim Start von SIGNAL eine Jobvariable angegeben wurde wird die Meldungsnummer ohne AVS in das Feld R ckkehrcode Anzeige der Jobvariablen eingetragen Hinweise e Wenn es f r einen Job mehre
64. wert fuer attributl e LOAD1 Format F r jede Datenbanktabelle wird eine eigene Datei erstellt Die S tze in der Ausgabe datei sind folgenderma en aufgebaut attributwertl attributwert2 Mit diesem Format k nnen die Daten in eine INFORMIX Datenbank ber die Anwei sung LOAD eingebracht werden e LOAD2 Format F r jede Datenbanktabelle wird eine eigene Datei erstellt Die S tze in der Ausgabe datei sind folgenderma en aufgebaut attributwertl attributwert2 Mit diesem Format k nnen die Daten direkt in relationale Datenbanken z B Microsoft Access mit den dort vorhandenen datenbankspezifischen Anweisungen eingebracht werden U21462 J Z125 7 239 Anweisungen von AVAS QUER Dienstprogramm AVAS QUER Kennzeichen ob ein zugeordnetes Dokument in der DOCLIB vorhanden ist Um festzustellen ob ein Dokument in der DOCLIB vorhanden ist versucht AVAS QUER ein Inhaltsverzeichnis f r alle Benutzerkreise zu erstellen Wenn f r den Benutzer keine Berechtigung f r COPY ELEMENT vergeben wurde erstellt AVAS QUER das Inhaltsver zeichnis nur f r den Benutzerkreis des Benutzers und gibt die Meldung AVSQ028 aus F r Netze oder Orders denen ein Dokument aus dem Systembenutzerkreis zugeordnet wurde kann dann nicht festgestellt werden ob das Dokument vorhanden ist In den Tabel len netdoktab und orderdoktab wird das Kennzeichen dokvorh in diesen F llen auf N gesetzt Zu beachten ist dass die
65. Ablaufdaten aus dem Installationsverzeichnis gel scht werden m ssen sie vorher gesichert werden Auch hier ist es sinnvoll diese erst gar nicht im Produktinstallationspfad zu speichern U21462 J Z125 7 451 Deinstallation der AVAS Server AVAS SV Plattform bergreifende Jobsteuerung 11 2 2 Deinstallation von AVAS SV auf Windows Systemen Der Produkteintrag AVAS NT unter Start Einstellungen Systemsteuerung lt Software kann im Microsoft Windows blichen Verfahren entfernt und damit das Produkt deinstalliert werden Das Deinstallationstool von AVAS NT ist nur in Englisch verf gbar Nach Auswahl von AVAS NT aus der Produktliste und Starten der L schaktion mit Hinzuf gen Entfernen erscheint eine Produkt bersicht der installierten AVAS NT Komponenten Die zu l schenden Komponenten k nnen einzeln oder alle selektiert werden Mit dem Aktionsknopf lt Deinstall gt wird die Deinstallation der ausgew hlten Kom ponenten eingeleitet Die dazugeh rigen Dateien Verzeichnisse und Registry Eintr ge werden gel scht Der Windows Dienst steht nach der Deinstallation der AVAS SV Komponente nicht mehr zur Verf gung Eventuell vorhandene Anwenderdaten in den Installationsverzeichnissen der Komponen ten werden ebenfalls gel scht Daher ist es durchaus sinnvoll diese vor einer Produkt Deinstallation zu sichern oder die Ablaufumgebung so zu gestalten dass Anwender bzw Ablaufdaten erst gar nicht ins Produktinstallationsv
66. Bei der Netzplanung kann dem Netz f r den Ablauf in der Produktion ein neuer Name vergeben werden Dies erleichtert das Verfolgen eigener Netzabl ufe siehe Handbuch AVAS Anweisungen 1 U21462 J Z125 7 Einleitung nderungen gegen ber der vorigen Handbuchausgabe ADD JOB LOG bei LOG FILE NONE mehrere Protokolldateien zulassen Wenn wegen Problemen mit SIGNAL oder DCAM keine Protokolldatei signalisiert wer den konnte k nnen jetzt nachtr glich mehrere Protokolldateien nach AVAS bernom men werden siehe Startparameter zur Steuerung der Protokollverarbeitung auf Seite 118 und Handbuch AVAS Anweisungen 1 NET CONTROL Job Informationen aus BS2000 Kommando SHOW JOB STATUS Bei der Produktionskontrolle k nnen bei NET CONTROL f r bestimmte Struktur elemente Informationen aus dem BS2000 OSD bernommen oder auch Aktionen an gesto en werden JOB Jobinformation lesen SHOW JOB STATUS JOB Job im BS2000 OSD abbrechen CANCEL JOB COND JVA Jobvariableninhalt lesen SHOW JV JOB Nachricht an den Job senden INFORM JOB JOB Nachricht an die STXT Routine senden INFORM PROG Siehe Handbuch AVAS Anweisungen 1 START EXIT mit Parametern ber den RZ Exit AVEX2001 werden zus tzliche Informationen ber das ausgew hlte Objekt zur Verf gung gestellt wie z B Name des zu planenden Netzes Struktur Index Function Typ Function Name Condition Net Name Subnetz Name Job Name Adresse des CMD Feldes siehe A
67. Beim PLANNED NET MODIFICATION Report werden alle ausgew hlten Netze in den Report bernommen 7 1 8 Zuordnung der Ein Ausgabedatei bei FUNKTION SORT Im OUT OF PLAN Report k nnen die Daten der Netze nach unterschiedlichen Kriterien sortiert werden Zum Sortieren muss dem REPORT Generator eine Ein Ausgabedatei zugeordnet werden ber das BS2000 Kommando SET FILE LINK m ssen der Ein Ausgabedatei folgende Dateikettungsnamen zugeordnet werden LINK NAME SORTIN oder LINK NAME SORTOUT U21462 J Z125 7 287 REPORT Generator AVAS Reports Wenn FUNKTION SORT nicht zusammen mit FUNKTIONZCREATE aufgerufen wird k n nen auch mehrere Eingabedateien zugeordnet werden LINK NAME SORTINO1 LINK NAME SORTINO2 Den Arbeitsdateien m ssen bei FUNKTION CREATE entsprechend unterschiedliche Namen zugeordnet werden Beispiel f r die Kommandos bei FUNKTION ALL SET FILE LINK LINK NAME SORTIN FILE NAME AVAS RPRT WORK PNM SET FILE LINK LINK NAME SORTOUT FILE NAME AVAS RPRT WORK PNM SET FILE LINK LINK NAME SORTINOl FILE NAME AVAS RPRT WORK OOPI SET FILE LINK LINK NAME SORTINO2 FILE NAME AVAS RPRT WORK OOP2 SET FILE LINK LINK NAME SORTOUT FILE NAME AVAS RPRT WORK OOP Mit den REPORT Anweisungen SORT STATE ORDER und SORT FIELDS ORDER kann der Benutzer die Sortierreihenfolge im OUT OF PLAN Report festlegen Die Anweisungen m ssen nur bei FUNKTION SORT angegeben werden Hinweis Beim PLANNED NET MODIFICATION Rep
68. Das Programm AVAS QUER wird ber die Prozedur aufgerufen Die Ausgabedatei output soll im INSERT Format erstellt werden und anschlie end im UNIX System unter dem Namen insert sgl verf gbar sein LL PROCEDURE LIB AVASS SYSPRC AVAS 070 ELE AVS QUER 1 amp FORMAT 2 3 STALLIERT IST amp AVUSERID 4 EITS PRIMARY BEARBEITUNG WIRD V7 0A VOM 2005 03 31 GELADEN S COMPUTERS GMBH 2005 ALLE 5 ARK AUSGABEFORMAT LOAD INSERT BER ION EME AUSGABEDATEI AUSGABE r output UF DER AVAS QUER I BENE SYSTEM DATEI AVASQUER VERS GHT C FUJITSU SI RMAT insert ARK NAME DER SGABE avas que ARK USERID A USERID AVAS SSM3034 ANGEGE CA RE amp FO RE amp AU RE amp AV 7 FORTGESETZT BLS0500 PROGRA BLS0552 COPYRI HTE VORBEHALTE 7 7 REC AVS2201 START AVASQUER V07 0A400 2005 04 04 12 34 04 6 AVS2800 BITTE ANMELDE DATEN EINGEBE 7 signon avas user id test password test avas system id sysidsy 8 9 ormat name insert reate format f C select object net name net001 calendar name examp 10 11 arams yes AVASQUER V07 0A00 NORMAL BEENDET SSM3034 ANGEGEBENE SYSTEM DATEI BEREITS PRIMARY BEARBEITUNG WIRD 13 U21462 J Z125 7 system p d AVS2310 SYSTEM TGESETZT en FOR im Zielsystem hier UNIX Plattform ncopy lt partnerrechner gt o
69. Die Anweisung wird nur beim OUT OF PLAN Report verarbeitet Die Anweisung muss nur bei FUNKTION SORT angegeben werden SORT FIELDS ORDER liste felder Liste von Feldnamen nach denen die Netze sortiert werden sollen NET NAME Netznamen nach denen sortiert wird Der Netzname beinhaltet den Benutzerkreis und das Datum PLAN START E DELAY Versp tungen bez glich der vorgesehenen Startzeit EARLIEST START des Netzes nach denen sortiert wird Die Sortierung erfolgt absteigend EARLIEST Gemap den vorgegebenen Werten f r EARLIEST START wird sor tiert MaBgebend ist der aktuelle Wert des Netzes zur Zeit der Aus wertung der Journaldatei Die Sortierung erfolgt aufsteigend STATE Gem dem globalen Status der Netze siehe Seite 305 wird sor tiert Der Feldname STATE muss nicht angegeben werden Er ist immer das erste Sortierfeld auch wenn er in einer anderen Position in der Liste angegeben wird Wenn die Anweisung nicht angegeben wird wird in der intern festgelegten Reihenfolge sor tiert SORT FIELDS ORDER Z STATE NET NAME E DELAY EARLIEST Wenn nur einige Feldnamen angegeben werden werden die weiteren in der intern festge legten Reihenfolge angeh ngt 298 U21462 J Z125 7 REPORT Anweisungen SORT STATE ORDER SORT STATE ORDER Festlegen der Reihenfolge der Netze f r die Reportdatei Mit SORT STATE ORDER wird die Reihenfolge festgelegt in der die Netze gemap ihrem aktuellen globalen Status in der Journaldatei
70. ERGEBNIS RV 0 JOB ABGEBROCHEN Ende 2 Fehler vor Start des R 3 Jobs ERGEBNIS RV 0 JOB NOCH NICHT GESTARTET Ende 3 Fehler nach Start des R 3 Jobs ERGEBNIS RV 0 JOB SCHON GESTARTET ERGEBNIS 8 LOG Datei 10eschjob 1og 3 version 1 0B30 0g Time MsgId No Text 929 101404 00 516 Job wurde gestartet 929 101404 00 550 Step 001 gestartet Programm RSBTCDEL Variante EICH FERTIG Benutzername EICH 929 101411 BT 146 Es wurden 237 Jobs gel scht 929 101411 00 517 Job wurde beendet U21462 J Z125 7 set goto Exit rem set goto Exit rem set Ende echo paus AVASR Job 1 Date 20040 20040 20040 20040 510 AVAS SV Plattform bergreifende Jobsteuerung Steuerung von SAP R 3 Jobs mit AVAS Windows Jobs die aus AVAS unter BS2000 OSD gestartet werden Der Job BS2 EXT PRI job wird auf Windows Systemen mit den Parametern gestartet die aus dem USER PAR FILE BS2 EXT PRI par bernommen wurden Er startet wiederum einen mySAP com Job mit dem Namen BS2NTEXTPRI der aus 3 Job Steps besteht e Im Job Step 1 wird das externe Programm Is ausgef hrt e Im Job Step 2 wird das ABAP 4 Programm RSPFPAR mit der Variante GW zum Ablauf gebracht e Im Job Step 3 wird abschlie end noch das externe Programm pwd ausgef hrt Die bergebenen Print Parameter gelten f r alle Steps eines Jobs Sie kommen aber nur bei Steps mit ABAP 4 Programmen die Listen produzieren zur Geltung
71. Meldungsdateien Die Meldungsdateien f r AVAS muss der BS2000 Systemverwalter bei der BS2000 Systemgenerierung in eine EKP Meldungsdatei einmischen oder mit dem BS2000 Kom mando MODIFY MSG FILE ASSIGNMENT bei Bedarf zuschalten Im letzteren Fall sind mit dem Programm MSGLIB siehe Handbuch Dienstprogramme 5 aus der ausgelieferten vollst ndigen Prim rdatei eine Meldungs Ausgabedatei Typ MSG und eine reduzierte Meldungs Prim rdatei Typ HELP zu erzeugen 3 1 Starten und Beenden der AVAS Prozesse 3 1 1 Systemstart und Systemsicherheit Der AVAS Dialogbetrieb setzt voraus dass auf die Daten in der Ablaufdatei und Journalda tei sowie auf die Bibliotheken zugegriffen werden kann Mit der Anmeldung an das AVAS Anwendungssystem schlieBt sich der Benutzer auch an die zentralen Zugriffsprozesse an F r den Betrieb der AVAS Ablaufsteuerung muss auf die Ablaufdatei und Journaldatei zu gegriffen werden k nnen Die Zugriffsprozesse m ssen vor Beginn des Betriebes geladen werden und aktiviert sein Wenn ein Prozess nicht aktiviert ist k nnen Funktionen die die Dateien ben tigen nicht benutzt werden Mit dem Prozess Server berwachung siehe Abschnitt Prozess Server berwachung auf Seite 486 kann die von AVAS unterst tzte und in der Konfigurationsdatei eingetragene Serverkonfiguration berwacht werden Server Jobs werden nur auf aktiven Servern Ser ver im Zustand RUNNING gestartet Der Prozess Server berwachun
72. REDEF PICTU PICTU PICTU PICTU REDEF PICTU PICTU PICTU PICTU PICTU PICTU PICTU PICTU REDEF PICTU PICTU PICTU USPF ER ERJN ERIN RSVT ER USLB 511 CDNT CDNM CDNN CDNI ER LTI CDVL ER FELLE FILLER AVSC FILL FILLER AVSC AVSC AVSC FILL FILLER AVSC AVSC AVSC AVSC AVSC AVSC FILL AVSCPAR3 FILLER AVSC AVSC FILL Programmschnittstelle von AVAS 15 L5 5 5 L5 5 E 5 OO On On 01 5 L5 E 5 END OF COPY ELEMENT 10 10 10 10 10 U21462 J Z125 7 Programmschnittstelle von AVAS Cobol Schnittstelle AVSCOBBO Kopf des Ergebnisbereichs definieren Das COPY Element AVSCOBBO definiert den Kopf des Ergebnisbereichs An diesen Bereich m ssen die funktionsspezifischen Bereiche angeschlossen werden U21462 J Z125 7 47100687 AVAS AVSCOBBO COPY Aufruf Aufl sung des COPY Elements AVSCOBBO COPY AVSCOBBO 002 941006 AVSCOBBO COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED PROGRAM INTERFACE OUTPUT AREA EA ECT PICTURE S9 4 COMPUTATIONAL ER PICTURE X 10 FILE PICTURE X 54 ER PICTURE X 14 B
73. REMOVE FILE LI AVSQUER MODIFY FILE ATTRIBUTES FILE NAME amp AUSGABE SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 SKIP COM TO LABEL FE amp ENDE FELOAD REMAR FEk REMAR REMOVE FILE L AVSCDAY MODIFY FILE ATTRIBUTES FILE NAME amp CDAYSYM SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 REMOVE FILE L AVSNET MODIFY FILE ATTRIBUTES FILE NAME amp NET SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 REMOVE FILE L AVSNETD MODIFY FILE ATTRIBUTES FILE NAME amp NETDOK SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 REMOVE FILE L AVSNETS MODIFY FILE ATTRIBUTES FILE NAME amp NETSYM SUPPORT ANY DISK SPACE RELEASE CNUMBER OF PAGES 9999 REMOVE FILE L AVSNETT MODIFY FILE ATTRIBUTES FILE NAME amp NETTXT SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 REMOVE FILE L AVSORD MODIFY FILE ATTRIBUTES FILE NAME amp ORDER SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 REMOVE FILE L AVSORDD MODIFY FILE ATTRIBUTES FILE NAME amp ORDERDOK SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 REMOVE FILE L AVSORDS MODIFY FILE ATTRIBUTES FILE NAME amp ORDERSYM SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 REMOVE FILE L AVSORT 236 U21462 J Z125 7 Dienstprogramm AVAS QUER Arbeiten mit AVAS
74. RUN TIME HO4ENT DS CL19 END TIME HO4AZE DS CL6 ANZAHL ERRORS DS Ce DS Ce DS CL341 RESERVIERT HOAUINF DS 0CL256 INFO aus AVA H ANWEISUNG HOAUSKY DS 602 SYSTEM SCHLUESSEL H HOAURKY DS CL2 USER SCHLUESSEL 51 99 HOAURDT DS 02 DATEN ZUM SCHLUESSEL ORG HOA4URKY HOAUIKY DS 602 SCHLUESSEL 01 00400185 DS 0 2 NAME BETRIEBSSYSTEM HOAUIBV DS 0 0 VERSION BETRIEBSSYSTEM HOAUIHN DS CL HOST BCAM NAME HOAULIP DS 05 IP ADRESSE HOAUICV DS 01 CPU VERBRAUCH U21462 J Z125 7 ho Po PA PA P P P P P P P P P P P P DA 228 Sicherung und Reorganisation Aufbau der History Datei HO4UIIO DS CL16 ANZAHL I O DS CL52 RESERVIERT HO4U1UD DS CL128 USER DATEN BEREICH 01 DS 4CL256 RESERVIERT DS CL31 RESERVIERT HOAWTER DS CL9 WAIT TIME ERROR HOAANZS DS CL2 ANZAHL TABELLENSEGMENTE HO4AEWT DS 0C ANF ADR ERROR WAIT TIMES DS 10CL220 START RUN TIME 1 10 1 HO4E DS 0C END ADR ERROR WAIT TIMES HOALREC EQU HO4HO4 LAENGE SATZ H04 ORG HO4AEWT HO4ERRT DS CL19 ERROR TIME HOAWAIT DS CL9 WAIT TIME HOARSTT DS CL19 RESTART TIME HO4JVVE DS CL128 MONJV INHALT BEI ERROR DS CL45 RESERVIERT HOALSEG EQU HOA4ERRT SEGMENT LAENGE Hinweise Bei Netzen die unter AVAS V4 0A und V4 1A ber REPEAT NET zur Verarbeitung frei gegeben wurden steht der Paramet
75. SATZBESCHREIBUNG SATZ 16 S16JNAM DS CL64 JOB NAME S16JLIB DS CL6 JOB LIB JMDLIB JMDSYS JCLLIB JCLSYS S16516L EQU S16S16A LAENGE DER DATEN S16LEN EQU N3JRNS Definitionen Satzschl ssel 21 ORG N3INH S21 AVASJRN S21 SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 1 5215218 DS 0C SATZBESCHREIBUNG SATZ 21 S21UPAF DS CL54 FILE NAME S21UPAR DS CL124 PARAMETER SATZ 521521 EQU 064 LAENGE DER DATEN S21LEN EQU N3JRNS U21462 J Z125 7 2038 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Definitionen Satzschl ssel 31 ORG N3INH S31 AVASJRN S31
76. SAVED gesetzt Reorga nisationsanweisung FUNKTION SJOUR Wenn die Reorganisationsanweisung HISTORY SAVE OPTION angegeben wird wer den ausgew hlte Daten von Netzen im Status ENDED auch in der HISTORY Datei HSTSYS gespeichert 3 Aus der HISTORY Datei werden die Daten von Netzen entfernt die ber die Reorgani sationsanweisungen HISTORY DELETE DATE und HISTORY KEEP RECORDS bestimmt werden Reorganisationsanweisung FUNKTIONZHISTORY U21462 J Z125 7 165 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation 4 Die Netze mit Status ENDED SHIFTED oder ABENDED werden vollst ndig in der Ablaufdatei gel scht Der Netzeintrag ist nach der Reorganisation nicht mehr vorhan den und wird bei NET CONTROL und SHOW NET STATUS nicht mehr angezeigt 5 Bedingungseintr ge werden in der Ablaufdatei gel scht wenn der Bedingungseintrag sich im Status ENDED oder ABENDED befindet und die LIFE TIME des Bedingungseintrags abgelaufen ist COND TYPE NET JOB der Bedingungseintrag mit der Anweisung DELETE CONDITION DESCRIPTION oder durch ein Strukturelement mit der Funktion FU D logisch gel scht wurde COND TYPE VAL RES NET JOB F r einen Reorganisationslauf k nnen ein oder mehrere der oben angegebenen Schritte ber ggf mehrfache Angabe des Parameters FUNKTION angefordert werden Diese Schritte werden dann in der oben angegebenen Reihenfolge durchgef hrt Eine andere Reihenfolge der einzelnen Reorganisa
77. Seite 18 beschrieben sind Die Datei kann mit dem EDT erstellt bzw bearbeitet werden e Periodendatei PERDAT In dieser ISAM Datei werden die Perioden Zeitabschnitte innerhalb des Kalenders gespeichert U21462 J Z125 7 53 Generierung des AVAS Systems Installation und Generierung e Kalenderbibliothek CALLIB In dieser Bibliothek werden die Kalender gespeichert die f r jeden Benutzerkreis durch die Generierungs Parameter oder die Netzbeschreibungen definiert werden e Netzbibliotheken NETSYS oder NETLIB In den Netzbibliotheken werden die Netzbeschreibungen gespeichert Die Netz beschreibungen in der System Netzbibliothek NETSYS sind systemweit f r alle Benutzer verf gbar Die Netzbeschreibungen in der Benutzer Netzbibliothek NETLIB sind nur f r die Benutzer des zugeh rigen Benutzerkreises verf gbar e Bibliotheken f r Jobs und JCL Bausteine JCLSYS oder JCLLIB In diesen Bibliotheken werden die Jobs und JCL Bausteine gespeichert F r JCLSYS und JCLLIB gilt sinngem das Gleiche das bei den Netzbibliotheken beschrieben ist e Dokumentationsbibliotheken DOCSYS oder DOCLIB In diesen Bibliotheken werden die Dokumentationselemente gespeichert Die Doku mentationselemente in der DOCSYS sind systemweit verf gbar Die Bearbeitung der Elemente in der DOCLIB kann eingeschrankt werden auf die Benutzerkreise der Benut zer e Bibliothek der Protokolldaten LOGSYS In dieser Bibliothek werden die Ablaufprotokolle
78. U21462 J Z125 7 183 Sicherung und Reorganisation Ausgabe der Journalliste Die Journals tze eines Produktionszeitraums k nnen mit der Prozedur AVS LSTJRNDAT Element der Bibliothek SYSPRC AVAS 070 aus der Sicherungsdatei in eine Druckdatei aufbereitet werden Sie ben tigt die folgenden Anweisungen die ber SYSDTA eingelesen werden INPUT FILE filename Name einer Sicherungsdatei bzw Name der gemischten und sor tierten Sicherung eines Produktionszeitraums OUTPUTR FILE filename Name der LIST Datei Wenn OUTPUT FILE nicht angegeben wird wird gesetzt AVAS LIST JOURNAL jjmmtt hhmmss berschrift der Listen Wenn HEADER nicht angegeben wird wird der Name der LIST Datei angenommen Funktion Listen aller Netze Funktion Listen eines Netzes oder einer Netzgruppe Der Name muss ber NET NAME vorgegeben werden Wenn FUNKTION nicht angegeben wird wird ALL angenommen Ausgeben der OUTPUT AREA Die OUTPUT AREA wird nicht mit ausgegeben Die OUTPUT AREA wird ausgegeben aber nicht aufgel st darge stellt Alle Daten der OUTPUT AREA werden mit Bezeichnungen ausge geben Wenn FORMAT nicht angegeben wird wird SHORT angenommen HEAD ER text FUNK TION ALL NET FORMIAT SHORT NORMAL LONG NET NAME netname Name eines Netzes oder einer Netzgruppe Es kann nur ein Netzname oder eine Netzgruppe vorgegeben wer den Diese Anweisung ist nur in Verbindung mit FUNKTIONZNET m glich Es wer
79. Wert Beenden des TRANSFER Programms Das TRANSFER Programm beendet sich nachdem alle Informationen und Daten an den CENTRAL Prozess gesendet wurden Wenn w hrend des TRANSFER Vorgangs Fehler auftreten z B falsche Parameter vorge geben CENTRAL Prozess nicht verf gbar Datei ist mit einem READ Kennwort gesch tzt wird eine Meldung ausgegeben Wenn beim Start von TRANSFER eine Jobvariable ange geben wurde und die Lange der Namensteile in Klammern wird die Meldungsnummer ohne AVS in das Feld R ckkehrcode Anzeige der Jobvariablen eingetragen Hinweise e Fehler beim TRANSFER Vorgang m ssen in den JCL Anweisungen zu einem abnor malen Ende des Jobablaufs f hren oder zu einem Eintrag in der Auftrags Jobvariablen Nur so kann die falsche bertragung der Protokolle auch zum Status ERROR des Strukturelements im Netz werden e Bei ADD JOB LOG und im TRANSFER Programm werden die Daten der Protokolle ber SYSDTA gelesen M gliche Dateiformate sind beim BS2000 Kommando ASSIGN SYSDTA beschrieben siehe Handbuch Kommandos Band 1 5 9 e Auftrage vom TYPE EXX k nnen mit dem TRANSFER Programm nur arbeiten wenn die externe Uberwachungs Jobvariable als Auftrags Jobvariable ber den Datei kettungsnamen SMONUJVJ ansprechbar ist U21462 J Z125 7 149 Administrationsaufgaben im Betrieb Administration von AVAS Erl uterungen zu den Steuerungs Parametern Beim Starten der Programme SIGNAL und TRANSFER werden Parameter zur
80. ZDL PASSWORD STD C X 0 STD Die Anmeldung bei der PLAM ZD erfolgt mit dem intern festgelegten Stan dardkennwort C Alphanumerische Eingabe des Kennworts 4 Zeichen s Sedezimale Eingabe des Kennworts 8 Zeichen Wenn ZDL PASSWORD nicht angegeben wird wird STD angenommen Beispiel In einem Reorganisationslauf sollen f r alle Netze im Status ENDED oder ABENDED gem der Reorganisationsanweisung NET NAME e die Protokolle gesichert und gel scht werden und e die Journale gesichert und gel scht werden Die Protokolle sollen in eine Bibliothek ausgegeben werden Erforderliche Anweisungen FUNKTION CABLDAT SJOUR JRNDAT JOBLOG NET NAME ALL bk netname DELETE PLAN NET YES JOBLOG SAVE OPTION STD JOBLOG SAVE LINK LIB linkname DELETE JOB LOG YES JOBLOG DELETE STATUS STD Wenn die in einem Reorganisationslauf gesicherten Protokolle und Journale erst im nach folgenden Reorganisationslauf gel scht werden sollen sind nur die Parameter in der Reorganisationsanweisung FUNKTION umzustellen FUNKTION JRNDAT SJOUR 08106 ABLDAT U21462 J Z125 7 181 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien Prozedurbeispiel f r die Reorganisation eines Netzes dessen Daten aus allen reorganisierbaren Dateien entfernt werden
81. ber Jobvariable vorgegeben werden erscheint im Dialog die Maske 481 5010 zur Eingabe der Anmelde Parameter EDT Prozedur f r JOBLOG Protokolle Wenn bei der Kontrolle der JOBLOG Informationen siehe Operation JOBLOG und Anwei sung SHOW JOB LOG im Handbuch AVAS Anweisungen 1 eine Prozedur zur Auswer tung erforderlich ist kann der Name in den Stellen 129 256 der Jobvariablen eingetragen werden Name der EDT Prozedur f r JOBLOG Der Name ist in der Form FILE oder LIBRARY anzugeben und muss der Beschreibung der EDT Anweisung INPUT Format 2 entsprechen Durch die EDT Anweisung PROC lt procnr gt in der EDT Prozedur wird die Abteilungsnum mer des EDT festgelegt Diese Abteilungsnummer ist dem AVAS Dialogbenutzer zur Aus f hrung mit DO lt procnr gt mitzuteilen 106 U21462 J Z125 7 Administration von AVAS Starten und Beenden der AVAS Prozesse 3 1 3 Starten und Beenden der Zugriffsprozesse Starten der Zugriffsprozesse Ein Zugriffsprozess wird durch Aufruf eines ENTER JOB Kommandos erzeugt In der ENTER Datei f r die Zugriffsprozesse m ssen folgende Kommandos vorhanden Sein e Eine Dateizuweisung BS2000 Kommando SET FILE LINK f r die AVAS System Parameterdatei mit dem Dateikettungsnamen AVASSYS Auf die Datei m ssen mehrere Prozesse zugreifen k nnen Die Datei wird mit SHARED UPDATE YES er ffnet e ADD PASSWORD Kommandos f r alle Dateien die mit einem READ oder WRITE PASSWORD versehen sind
82. cccccccccccccccc eeeeeeee Folge2 bbbbbbbbbbbbbbbbbbbbbbbbbbbbb Folge3 dddddddddddddddddddddddddddddd l l MOD SYS PAR Zuordnung Anderung LIBs neue LIBs f r BK1 f r BK1 ZDs AVAS ZD Start AVAS Sitzung USER 1 Benutzer Sitzung BK1 Beginn durch Anmeldung USER 2 Wie USER 1 f r einen 2 Benutzer BK1 USER 3 Wie USER 1 f r einen 3 Benutzer BK2 Folge1 USER 1 er ffnet Zugriffsfolgen auf LIBs a generierte LIBs c generierte LIBs MOD SYS PAR noch nicht wirksam wegen USER 2 Zugriffsfolge b e Anderung der LIB Zuordnung wirksam Folge2 USER 2 er ffnet Zugriffsfolgen auf LIBs b generierte LIBs Folge3 USER 3 er ffnet Zugriffsfolgen auf LIBs d kein Einfluss da anderer Benutzerkreis U21462 J Z125 7 57 Versionswechsel mit ABLDAT und JRNDAT Installation und Generierung 2 2 5 3 AVAS Versionswechsel mit ABLDAT und JRNDAT Bei einem Versionswechsel k nnen die Ablaufdatei ABLDAT und die Journaldatei JRNDAT bernommen werden damit die Bedingungseintr ge nicht neu eingegeben werden m ssen Damit mit dem Datenbestand der alten Version gearbeitet werden kann m ssen die SYSTEM ID und die R C S Namen ge ndert werden bernahme der Ablaufdatei und Journaldaten aus der Vorg ngerversion Bei einem Wechsel auf eine h here AVAS Version k nnen die Daten der Ablaufdatei ABLDAT und der Journaldatei JRNDAT in die neue Version bernommen werden Dazu m ssen in den Dateien der neuen Version die Systemkennu
83. der Journale und der Protokolle im AVAS System siehe unten Jede Reorganisationsfunktion darf nur einmal angegeben werden Bei Einzelangabe kann jede Funktion genannt werden Die Standardreihenfolge der Funktionen ist JRNDAT SJOUR ABLDAT JOBLOG JRNDAT Gesicherte Journale Netzstatus SAVED werden aus der Journaldatei ent fernt SJOUR Die Journale von Netzen im Status ENDED oder ABENDED werden gesi chert Das Netz wird in den Status SAVED gesetzt Wenn die Reorganisa tionsanweisung HISTORY SAVE OPTION STD NET angegeben wird werden von Netzen im Status ENDED Daten in der History Datei gespei chert ABLDAT Die Funktion sucht alle Netze mit Status ENDED oder ABENDED in der Ablaufdatei Mit der Reorganisationsanweisung JOBLOG SAVE OPTION STD wer den alle Protokolle dieser Netze gesichert und mit Status SAVED gekenn zeichnet Mit der Reorganisationsanweisung DELETE PLAN NET YES werden die Netze im Produktionsplan gel scht In der JRNDAT erhalten die Netze den Status DELETED Danach werden die Netze aus der Ablaufdatei gel scht Netze deren signalisierte Protokolldateien den Status ASSIGNED oder ERROR besitzen werden nicht reorganisiert 172 U21462 J Z125 7 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien JOBLOG Alle Protokolle im Status TRANSFERRED ADDED oder IGNORE werden gesichert und in den Status SAVED gesetzt Wenn JOB LOG DELETE STATUS gesetzt ist werden alle Protokolle mit
84. i 373 READ AVAS LIBRARY Lesezugriff auf Journaldatei und Ablaufdatei 376 10 2 Aufbau der Verst ndigungsbereiche 380 10 3 Assemblar Schnittstelle a uoa pice Rt ee an 386 10 3 1 Programmbeispiel in Assembler eres 387 10 3 2 Makros zur Definition der Verst ndigungsbereiche 389 AVSASSAD Eintrag im Netzverzeichnis der Ablaufdatei definieren 389 AVSASSAN Netzstrukturdaten definieren 393 AVSASSBC Kommunikationsbereich definieren 400 AVSASSBO Kopf des Ergebnisbereichs definieren 404 AVSASSBW Arbeitsbereich definieren 405 AVSASSCD Verzeichniseintrag Bedingungseintr ge in Ablaufdatei definieren 407 AVSASSCE Bedingungseintrag in der Ablaufdatei definieren 409 AVSASSJD Journal Inhaltsverzeichniseintrag definieren 411 AVSASSJN Journalsatzkopf definieren 414 AVSASSRT Resultatbereich definieren 416 10 4 Cubot sohinitfstellb sn 418 10 4 1 Programmbeispiel in ed issssaesssastts sa c ERR aan aaa ERA 419 10 4 2 COPY Elemente f r Anweisungen sisse eee 421 AVSCOBAD Eintrag im Netzverzeichnis der Ablaufdatei definieren 421 AVSCOBAN Netzstrukturdaten definieren 423 AVSCOBBC Kommunikationsbereich definieren 427 AVSCOBBO Kopf des Ergebnisbereichs definieren 430 AVSCOBBOQ Schl ssel f r AVSCMDC
85. letzter Tag des Monats Trennzeichen f r Tag und Monat Monat mm realer Monat Ein realer Monat ist nur mit einem realen Tag zugelassen 0 aktueller Wert aus dem Tagesdatum m aktueller Monat m Monate m aktueller Monat m Monate m 0 1 oder 2 Trennzeichen f r Monat und Jahr 320 U21462 J Z125 7 BATCH Anweisungen CREATE PERIOD Jahr 0 aktueller Wert aus dem Tagesdatum Ein reales Jahr kann nicht angegeben werden Werden ein realer Tag und ein realer Monat angegeben muss das Jahr mit 0 angegeben werden nur in Verbindung mit beim Tag F llt der Tag auf einen Sonntag wird der vorausgehende Samstag einge setzt nurin Verbindung mit beim Tag F llt der Tag auf einen Sonntag oder Samstag wird der vorausgehende Frei tag eingesetzt nurin Verbindung mit 0 0 aktuelles Datum Es wird zum aktuellen Datum die aktuelle Uhrzeit angenommen Wochentag in Woche n w n n ter Tag der Woche 1 Montag 7 Sonntag Trennzeichen f r Wochentag und Woche w laufende Woche w Wochen w laufende Woche w Wochen w 0 yg 3 0 Mittwoch der laufenden Woche Beispiele PERIOD NAME HEUTE PERIOD START DATE 0 0 PERIOD END DATE 0 0 HEUTE von 00 00 Uhr bis 23 59 Uhr des laufenden Tages ERIOD NAME HEUTE ERLEDIGT PERIOD START DATE 0 0 PERIOD END DATE 0 0 HEUTE ERLEDIGT von Heute 00 00 Uhr bis zur aktuellen Uhrzeit des laufenden Tages RIOD NAME HEUTE RES
86. orte TEMPORARY LOCATIONS im MAREN Archiveintrag aktualisiert Diese Verlage rungsprozedur kann der Arbeitsvorbereiter aufrufen wenn er die Datentr ger von den ein zelnen Archiven zu jenen Anlagen transportiert an denen die Jobs des freigegebenen Netzes ablaufen sollen Wie in der Bandmontierliste des Operateurs so wird auch in dieser Prozedurdatei jede VSN nur einmal aufgef hrt Wenn f r irgendeinen Datentr ger die ber die MARENADM Anweisung MODIFY VOLUME ATTRIBUTES bewirkte Verlagerung nicht durchgef hrt werden kann z B weil der Datentr ger gerade an einer Anlage verarbeitet wird wird die Prozedur nicht abge brochen sondern normal mit der n chsten VSN fortgesetzt Es muss jedoch sichergestellt werden dass zum Ablauf des Netzes alle Datentr ger auch tats chlich verf gbar sind Beispiel f r den Aufbau einer Verlagerungsprozedur Die Verlagerungsprozedur hat den Dateinamen PRC AVAS RCS003 001218 113012 Sie wird unter der Kennung des Benutzers abgelegt der die Netze zur Produktion freigibt Diese Datei ist unter den gleichen Gegebenheiten wie im Beispiel Transportliste fol genderma en aufgebaut PROC A CAMARENADM MARENADM SYSFILE SYSDTA SYSCMD EXEC amp MARENADM MOD VOL ATTR VOL Y1A003 TEMP LOC CPUO03 STEP MOD VOL ATTR VOL Y1BOOl TEMP LOC DA12ZE02 STEP MOD VOL ATTR VOL Y1C002 TEMP LOC DA12ZEO2 STEP MOD VOL ATTR VOL Y1D001
87. r die Ande rung oder L schung ausgew hlt werden Schaltfl chen des Fensters Benutzerverwaltung Benutzer hinzuf gen Der unter Benutzername eingetragene Benutzer wird in die Benut zerverwaltung von AVAS SV aufgenommen F r jeden einzutragen den Benutzer muss ein Passwort angegeben werden Benutzer l schen Der unter Benutzername eingetragene Benutzer wird aus der AVAS SV Benutzerverwaltung gel scht Das Passwort muss nicht angegeben werden Benutzerdaten ndern Die Daten Passwort des unter lt Benutzername gt eingetragenen Benutzers werden ge ndert OK nderungen bzw Eintragungen werden erst wirksam nachdem die Schaltfl che OK aktiviert wurde Hinweis F r Jobs die auf Windows Systemen unter dem Systemkonto gestartet werden sollen muss in der Konfigurationsdatei des BS2000 OSD die Kennung SYSTEM eingetragen werden U21462 J Z125 7 481 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung 11 3 5 5 bergabe der Parameter an Server Jobs f r Windows Plattform Die Regeln zum Formulieren von Parametern f r Server Jobs sind im Handbuch AVAS Funktionen 2 beschrieben Beispiel Der Server Job wird wie alle von AVAS verwalteten Jobs in der JCLLIB der AVAS Kon figuration auf der BS2000 Seite gespeichert Die Kommandofolge sowie die Parameter k nnen mit EDIT JOB bearbeitet werden Dabei erfolgt die Anzeige mit EDT in den Arbeits dateien 0 Kommandofolge un
88. 02 12 19 16 05 2 PRIVATE TAPES REQUESTED WITH DEVICE TYPE T6250 AT LOCATION CPUO03 REMARK VOLUME IS EXPORTED INDEX JOBNAME CATID FROM LOC TO LOC VOLU 020 GEHALTO2 C3 CENTRAL CPUO03 Y1A00 010 GEHALTO1 CI02 CENTRAL DA12ZE02 0 010 GEHALTO1 CI02 DVA11 DA12ZE02 Y1C00 010 GEHALTO1 CI02 DVA11 DA12ZE02 Y1DOO 020 GEHALTO2 C3 DVA12 CPUO03 Y1B00 HH N m wm 270 U21462 J Z125 7 Kopplung AVAS mit MAREN Erstellen von Datentr gerlisten 6 3 2 Bandmontierliste Diese Datei hat den Namen OPR AVAS rcs yymmdd hhmmss rcs Name des Ablaufsteuerungssystems yymmdd hhmmss Datum und Uhrzeit der Produktionsfreigabe Diese Datei enth lt wie die Transportliste eine Liste aller zu einem Netz geh renden VSNs inklusive der Datentr ger die nur im Restart Fall ben tigt werden Sie zeigt dem Operateur an welche Datentr ger von einem Netz angefordert werden Wenn ein Datentr ger in einem Netz mehrfach verwendet wird wird er mehrfach in dieser Montierliste aufgef hrt Anforderungen f r SCRATCH und PRIVATE B nder erscheinen mit Ger tetyp bei priva ten Datentr gern auch mit der angegebenen Anzahl in der Datei Der Listenkopf und der Satzaufbau dieser Datei ist identisch mit dem der Transportliste des Arbeitsvorbereiters Es findet jedoch keine Sortierung statt sondern die VSNs und auch die Anforderungen f r SCRATCH und PRIVATE B nder werden in chronologischer Reihe
89. 448 AVAS System 13 avsr3 496 R3JobControl 14 von AVAS QUER 16 J JCL Baustein 530 JCLLIB 54 530 JCLnnn 25 29 163 JCLSYS 25 54 531 JMDLIB 54 163 531 JMDnnn 25 JMDSYS 25 54 531 JOB 531 Job 531 Ablaufprotokolle 136 statischer 537 Steuerung entferntes BS000 485 Steuerung UNIX 471 Steuerung Windows 476 tempor rer 537 JOB ACCOUNT 531 Jobbeschreibung Historie 69 JOB CAT 531 JOB CLASS 531 JOB DOC 531 JOB INDEX 531 JOB LOG 531 JOBLOG DELETE DATE Reorganisationsanweisung 176 551 Fragezeichen in Login Maske 67 freigegebene Netze steuern 130 F Tasten definieren 37 FUNCTION bei Strukturelement 530 FUNKTION Reorganisationsanweisung 172 Funktionsberechtigungen Definition 33 Funktionssatz 139 Funktionssteuerung Definitionen f r 43 Funktionstasten 37 G GENERATE JOB LOG 118 Generierung des AVAS Systems 18 Generierungsdatei erzeugen 19 GENPAR 53 Generierungs Parameter erstellen 48 GENPAR Generierungsdatei 53 GENPAR Datei generieren 51 H Historie Jobbeschreibung 69 Netzbeschreibung 69 History Datei Aufbau 214 Schl ssel 215 HISTORY Datens tze Satzaufbau 222 HISTORY DELETE DATE Reorganisationsanweisung 173 HISTORY DELETE OPTION Reorganisationsanweisung 174 HISTORY KEEP RECORDS Reorganisationsanweisung 175 HISTORY SAVE OPTION Reorganisationsanweisung 176 HLPLIB 31 HOLD NET BATCH Anweisung 334 hostname portnr 459 HOSTWAIT 121 486 Server 15 Server Jobs 455 HST
90. AVAS Server berwachungsprozess ist beendet Auftr ge an die AVAS Server berwachung sind als Eingabe in die kontrollierende Jobvari able ab Position 1 mit L nge 10 und folgenden Werten m glich CONFIG Die Konfigurationsdatei soll neu gelesen und verarbeitet werden nach dem sie ge ndert wurde SHUTDOWN Die Server berwachung soll sich beenden W hrend der Start Phase STARTING1 3 der Aktualisierung RUNNING und nach SHUTDOWN werden Eingaben an die kontrollierende Jobvariable nicht bearbeitet Die AVAS Server berwachung ist unter der Kennung zu starten unter der auch die Ablauf steuerung l uft Bei Fehlern in der Funktion werden Fehlermeldungen nach SYSOUT ge schrieben Die Ablaufsteuerung setzt beim Starten von Server Jobs deren Status auch in Abh ngig keit der beiden ersten Stellen der SV JV RUNNING wenn der Wert in den beiden Stellen der SV JV gleich R ist HOSTWAIT solange der Wert in den beiden ersten Stellen der SV JV ungleich R ist ERROR wenn eine entsprechende SV JV nicht vorhanden ist In diesem Fall kann der Serverauftrag nicht zum Ablauf gebracht werden Funktionen des AVAS Prozesses Server berwachung Ermitteln der Server aus der Konfigurationsdatei Beim Starten der Server berwachung werden die Konfigurationsdatei gelesen und die SV JVs entsprechend versorgt Die Server berwachung erzeugt SV JVs wenn es diese f r einen zu berwachenden Server noch nicht gibt Danach wird der Zustand der
91. AVSCOBJN abgelegt Die Struktur des Bereichs AVPSOUTP Ausgabedaten wird durch den Makro AVASJRN beschrieben Ein Cobol COPY Element f r die verschiedenen Journalsatztypen wird nicht mitge liefert 384 U21462 J Z125 7 Programmschnittstelle von AVAS Aufbau der Verst ndigungsbereiche Arbeitsbereich WRKAREA Der Arbeitsbereich nimmt alle Meldungen auf die AVAS bei der Verarbeitung einer Anwei sung ausgibt Die Ausgabe entspricht dem Protokoll das bei den AVAS BATCH Funktionen erstellt wird Mit dem Makro AVSASSBW bzw dem COPY Element AVSCOBBW werden ein Bereichskopf und eine Meldungstabelle generiert Die Anzahl der Tabelleneintr ge wird ber den COUNT Parameter gesteuert Im Arbeitsbereich werden in folgenden Feldern Informationen ausgetauscht AVSWFILE Name einer Datei in die die Meldungen an Stelle des Arbeitsbereichs abgelegt werden sollen Sie werden immer am Dateiende angef gt Der bisherige Inhalt der Datei geht also nicht verloren AVSWMGCT Anzahl der Meldungen die maximal in dem Bereich aufgenommen werden k nnen Der Wert 0 zeigt an dass kein Bereich zur Verf gung steht und die Meldungen stattdessen in die Datei geschreiben werden sollen Wenn AVSWMGCT eine 0 und AVSWFILE Leerzeichen enth lt erh lt das Benutzerprogramm keine Meldungen Die Verarbeitung wird aber durchge f hrt AVSWMGCR Anzahl der Meldungen die AVAS bei der Bearbeitung der Anweisung aus gegeben hat Wenn der Wert gr er als der im Fe
92. Adresse des RZ Exits Einbinden von MARENAV Bei der Kopplung des Moduls MARENAV an den RZ Exit AVEX7102 ist Folgendes zu beachten e Der Entry COLBIN ist in MARENAV f r sp tere Binderl ufe erkennbar gelassen LINK SYMBOLS KEEP COLBIN e Beim Modul MARENAV handelt es sich um eine in Assembler geschriebene COLUMBUS Prozedur mit Laufzeitsystem Die diesbez glich geltenden Regeln zur Programmverkn pfung sind zu beachten siehe Handbuch ASSEMBH 4 Anschluss von RZ Routinen neben MARENAV Wenn an den RZ Exits AVEX7101 und AVEX7102 eine oder mehrere RZ Routinen ange schlossen werden sollen kann der Modul AVOSEXTV benutzt werden AVOSEXTV besorgt das Verzweigen zu einzelnen RZ Routinen Hierzu muss die Source AVOSEXTV ge ndert und neu bersetzt werden Mit dem Makro AVEXSVV wird eingestellt zu welchen RZ Routinen am jeweiligen RZ Exit verzweigt wer den soll Makro Parameter AVEXSVV exitnr nnnn addr liste exitnr Angabe 4 stellig welcher RZ Exit bearbeitet werden soll z B 7102 f r den RZ Exit AVEX7102 addr Symbolische Adresse Entry in der RZ Routine die von AVO3EXTV mit der Schnittstelle des RZ Exits die Kontrolle erh lt U21462 J Z125 7 2 4 2 2 4 3 76 Installation und Generierung RZ Exits im AVAS System liste Mehrere Entry Adressen k nnen in einer Liste angegeben werden z B addr1 addr2 addr3 Hinweis AVOSEXTV behandelt die von den RZ Routinen an AVAS zur ck
93. Auftr ge vom AVAS Agenten AVSSINCM Sobald ein Auftrag eintrifft star tet er seinen Kindprozess AVSSTRT mittels fork Dadurch vererbt er ihm die Nachricht und die Verbindung Danach wartet er auf den n chsten Auftrag Mit AVSSINCM tauscht AVSREOCV keine weiteren Daten aus U21462 J Z125 7 471 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung AVSSTRT AVSSTRT ist programmtechnisch ein Teil von AVSRECV und m sste AVSRECV Kind genannt werden Da er im Server System aber als eigener Prozess mit eigenen Aufgaben l uft erh lt er zur besseren Unterscheidung in der Beschreibung einen eigenen Namen AVSSTRT analysiert die Nachrichten die vom AVAS Agenten im BS2000 OSD kommen und f hrt dabei folgende Arbeiten durch e AVSSTRT pr ft das Kommunikationskennwort lt comm pw gt siehe Abschnitt Aufbau der Konfigurationsdatei auf Seite 459 und die in der Nachricht bergebene Benutzer kennung die AVSSINCM aus der Konfigurationsdatei gelesen hat Wenn eine der bei den Angaben nicht stimmt betrachtet AVSSTRT den Auftrag als nicht authorisiert und beendet sich mit einer Fehlermeldung Gegen das Kennwort der Benutzerkennung findet keine Pr fung statt AVSSTRT be trachtet die Identifikation ber das Kommunikationskennwort und die Benutzerkennung als ausreichend e Wenn AVSRECV unter der Superuser Kennung privilegiert gestartet ist l
94. CAT CATID IN JVA ANCTK DS CL QUOTE 05 0 356 U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen CATID QUOTE JOB CATID QUOTE NET CAT STRING OF CATID RVED RVED E INFORMATION OF USER PAR FILE LIB SAM NET RESE RESE ITL TYPE SAM LIB STD NONE RD LENGTH MINIMUM PAR FILE MENT NAME DAR NAME RVED 357 RECO USER DOCU CALE RESE Externe Erstellung von AVAS Elementen X 7D X 7D CLA CL49 CL C9 Cr Cx NNA4A CL54 CL43 CL20 CL3 OF NNAA EQU EQU DS DS DS DS DS EQU EQU EQU EQU EQU DS DS DS DS DS EQU LEICK FENCK INCTI INTEX UPF USM UST UN c m m m m H INDOC LCAL U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen Externe Erstellung von AVAS Elementen AVASNET RECORDzZNS PREFIX N EQUZYES IL JHHHHE PREFIX N MACID N5 HHH LAM RECORD LENGTH LAM RESERVED PLAM SK LAM RESERVED PLAM SA ECORD KEY ERV RV RV IN Doro UV V m co mmm om m rrn X 000 m Kei gt lt T m vovmm UI UE m m 1m TTI TTI RECORD LENGTH MINIMUM TAB OF MAPS MAP NAME RESERVED MAP INFORMATION SEGM LENGTH NN5NFML NN5CE L SEGM COUNTER U21462 J Z125 7 MFCHK MF C PREFIX N MACIDZN5 DMACID N5D SUPPORT C D DS OF DS OF DS
95. CL1 DS CL3 DS CL30 DS CL2 PARAMETERS FUNCTION W FUNCTION D DS CLA EQU ND3A DS OF EQU ND3A D3A D3SLEN D3SSL D3FUNC D3TYPE D3IND D3NAM Hr E ND3LMIN ND3L 370 Externe programmtechnische Erstellung von Netzen IL JHHHHE PREFIX N MACID W3 HHH PLAM RECORD LENGTH PLAM RESERVED PLAM SK PLAM RESERVED PLAM SA RECORD KEY DESCRIPTION FUNCTION CODE DESCRIPTION TYPE CODE RESERVED INDEX AME RESERVED TYPE TI TYPE NET JOB RES VAL RESERVED RECORD LENGTH MINIMUM 371 Externe Erstellung von AVAS Elementen AVASNET RECORD W3 PREFIX N MFCHK MF C PREFIX N MACID W3 DMACID W3D SUPPORT C D DS OF DS OF DS H DS C DS C DS CL2 DS C DS X DS CL1 DS CL3 DS CL30 DS CL2 PARAMETERS FUNCTION W FUNCTION D DS CLA EQU NW3A DS OF EQU NW3A 3A 3SLEN 3SSL 3FUNC 3TYPE 3IND 3NAM Ed E EE NW3LMIN NW3L U21462 J Z125 7 Externe Erstellung von Auftr gen Externe Erstellung von AVAS Elementen 9 2 Externe Erstellung von Auftr gen BS2000 Jobs S Prozeduren Server Jobs und JCL Bausteine k nnen mit Jobgeneratoren erstellt und ber COPY ELEMENT in die AVAS Bibliothek JCLLIB eingelesen werden Die Jobs k nnen gem den AVAS Regeln AVAS Anweisungen und Variablen beinhalten Zu beachten ist dass die AVAS Anweisungen nicht a
96. CL2 0CL10 X CL9 CL3 0CL48 CL3 CL30 CL2 0CL10 X CL9 CL3 CL3 C S12S12A N3JRNS DS DS DS DS ORG DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS EQU EQU 2LIFT L2JSYN 2JRSP 2RSV 2RS 2RSJ 2RSTIT 2RST 2RSA1T 2RSV2 2RSI2 2RSJ2 L2RST2T 2RST2 2RSA2T 2RSV3 2RSI3 2RSJ3 2RST3T L2RST3 2RSA3T 2SELRV 2512 2LEN Co CA Co Go CA Co Co Lo Go Lo Lo Lo U21462 J Z125 7 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Definitionen Satzschl ssel 14 ORG N3INH S14 AVASJRN S14 SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 14 5145148 DS 0C SATZBESCHREIBUNG SATZ 14 S14EARL DS CL12 EARLIEST START SIALATS DS CL7 LATEST START SIALIFT DS CL7 LIFE TIME SIARUCS DS CL8 RUN CONT SYS S14NDSLT DS 0CL6 NET DELAY SOLUTION TEXT S14NDSL DS X NET DELAY SOLUTION CODE DS CL5 SIANTYP DS CL1 NET TYPE S14S14L EQU S14S814A LAENGE DER DATEN 514 EQU N3JRNS Definitionen Satzschl ssel 15 ORG N3INH S15 AVASJRN S15
97. Datei SYSLNK AVAS 070 muss mit dem Linknamen SYSLNK zugeordnet werden Die Meldungsdatei SYSMES AVAS 070 muss zugeordnet sein 17 U21462 J Z125 7 Generierung des AVAS Systems Installation und Generierung 2 2 Generierung des AVAS Systems Jedes AVAS System besteht aus e einem zentralen Zugriffsprozess ber den die Zugriffe auf die Ablaufdatei und die Jour naldatei ber UPAM abgewickelt werden Batchtask im folgenden UPAM ZD genannt e einem zentralen Zugriffsprozess ber den die Zugriffe auf alle Bibliotheken ber PLAM abgewickelt werden Batchtask im folgenden PLAM ZD genannt e wahlweise dem CENTRAL Prozess zum Sammeln der Ablaufprotokolle der aus einem Prim rprozess und einem oder mehreren Sekund rprozessen besteht e jeeiner Dialog Task f r jeden Benutzer des Systems e einer oder mehreren Ablaufsteuerungen Batchtask welche die Abwicklung der Netze kontrollieren e wahlweise einer Ablaufsteuerung auf einem angeschlossenen Server Rechner die die Verarbeitung von Server Jobs kontrolliert Alle Generierungs Parameter die f r die Beschreibung dieses Systems ben tigt werden sind in der Generierungsdatei GENPAR abgelegt In dieser Datei sind durch die Generie rungs Parameter definiert e die AVAS Systemkennung e die System Parameter der zentralen Prozesse e die Zuordnung der Dateinamen und Bibliotheken e die Beschreibung der Benutzerkreise e die Definit
98. Der Netzname darf verk rzt sein bk_ Alle Netze des angegebenen Benutzerkreises werden reorganisiert b Alle Netze der Benutzerkreise die mit dem angegebenen Zeichen begin nen werden reorganisiert OUTPUT FILE Diese Reorganisationsanweisung legt ein Namenspr fix f r die Sicherungsdatei der Jour nals tze fest Die Anweisung wird nur zusammen mit FUNKTION SJOUR verarbeitet OUTPUT FILE name name Die ersten 22 Zeichen von name werden verl ngert mit Datum und Uhrzeit Format jjjmmdd hhmmss und als Dateiname f r die Journalsicherung verwendet Wenn der Name l nger als 22 Zeichen ist wird er ohne einen Hinweis auf die maximale L nge von 22 Zeichen gek rzt 178 U21462 J Z125 7 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien OUTPUT LINK Die Reorganisationsanweisung legt die Ausgabedatei f r die Journalsicherung ber einen Dateikettungsnamen fest Die Anweisung wird nur zusammen mit FUNKTION SJOUR aber nicht mit OUTPUT FILE name verarbeitet OUTPUT LINK name name Dateikettungsname der Ausgabedatei f r die Journalsicherung Die Sicherungsdatei muss vor dem Start des Reorganisationsprogramms mit dem BS2000 Kommando SET FILE LINK LINK NAME name zuge ordnet werden Hinweis Die Zuordnung einer Datei ber den Kettungsnamen ist besonders bei gro en Siche rungsdateien g nstiger da der Benutzer die Platzzuweisung der Dateigrope anpassen kann Bei OUTPUT FILE name wird die Dat
99. Der symbolische Starttermin eines Net zes wurde durch ein reales Datum ersetzt Dieser Vorgang erfolgt im Arbeits schritt Produktionsplanung automatischer Restart Ein fehlerhaftes Netz wird von AVAS automatisch am Aufsetzpunkt erneut gestartet U21462 J Z125 7 527 Fachworter AVAS JV Schnittstelle Die Kontrolle ablaufender Auftr ge wird gew hnlich ber eine Auftrags Jobvari able durchgef hrt Bei der AVAS JV Schnittstelle findet die Kontrolle ber die gleiche Jobvariable statt jedoch wird diese nicht vom BS2000 OSD als Auftrags Jobvariable ver sorgt sondern muss vom Benutzer dementsprechend versorgt werden AVAS Report Auswertung des AVAS Produktionsplans und der AVAS Journaldatei nach vor gegebenen Kriterien AVAS SYSTEM LIBRARY Name einer zentralen AVAS Bibliothek AVAS USER LIBRARY Name einer AVAS Benutzerbibliothek BATCH Anweisungen BATCH Anweisungen sind ausgew hlte Anweisungen die prozedural einge geben werden k nnen Bedingung Voraussetzung f r den Start eines Netzes oder einer Indexstufe eines Netzes siehe auch CONDITION TYPE Bedingungseintrag Bestandteil der ABLDAT f r Bedingungen des Typs NET JOB RES VAL ein Satz enth lt alle notwendigen Informationen f r den jeweiligen CONDITION TYPE Benutzerkreis Gruppe von Benutzern die auf gemeinsame AVAS Bibliotheken zugreifen CALLIB Linkname f r die Kalenderbibliothek CONDITION JVA NAME Name der JV welche an einer bestim
100. Die Ablauf steuerung tr gt diese Werte mit dem Satzschl ssel 08 02 in die Journaldatei ein bei der Sicherung der Journale werden sie in den HISTORY Satz mit KEY 04 bernommen Feld HOAUINF USER INFO aus AVA H Anweisung Zum Zeitpunkt der Reorganisation sollte auf die Datei nicht zugegriffen werden weil inkon sistente Zus nde auftreten k nnen und der Zugriff auf einzelne S tze gesperrt sein kann Die Satzbeschreibungen werden ber den Makroaufruf AVASJRN aufgerufen HkKAVASJRN amp pre kk Satzschl ssel 01 02 03 oder 04 KY Definitionen des ISAM Schl ssels amp pre Pr fix U21462 J Z125 7 215 Aufbau der History Datei Sicherung und Reorganisation Aufbau und Inhalt der HISTORY Datens tze KEY 01 History Netz komprimiert Fortsetzung U21462 J Z125 7 Spalten berschriften Inhalt Lange Satzschl ssel KEY 01 Benutzerkreis bk Netzname netname 12 Plan Start Datum Plan Start Zeit Symbolischer Starttermin SYMDAT NAME 20 Index 3 Jobname 30 Funktion FU N 1 Typ TYPE SUM 3 letzte Startzeit tt mm yyyy hh mm ss 19 letzte Laufzeit hhh mm ss 9 letzte Endezeit tt mm yyyy hh mm ss 19 Anzahl Abl ufe nnnn 4 mittlere Laufzeit Netz hhh mm ss 9 maximale Laufzeit Netz hhh mm ss 9 minimale Laufzeit Netz hhh mm ss 9 Range hhh mm ss 9 Standardabweichung hhh mm ss 9 mittlere Laufzeit Jobs hhh mm ss 9 maximale Laufzeit Jobs hhh mm ss 9 mittlere Wartezeit Conditi
101. GENPAR Eingabedatei mit Beschreibungen zum Generieren einer SYSPAR Datei Name einer SAM Datei GENPAR Ausgabedatei mit Beschreibungen zum Generieren einer SYSPAR Datei die neu erstellt werden soll Startparameter f r das Programm UPDATE USER NO YES NO Die Benutzerbeschreibungen sollen nur aus der Datei amp GENOLD bernommen werden YES Die Parameter der Benutzerbeschreibungen sollen aus der Datei amp SYSPAR bernommen werden Startparameter f r das Programm UPDATE FUTAB NO YES NO Die Funktionstabellen sollen nur aus der Datei amp GENOLD ber nommen werden YES Die Parameter der Funktionstabellen sollen aus der Datei amp SYSPAR bernommen werden Startparameter f r das Programm UPDATE USVAR NO YES NO Die Systemvariablen der Benutzer sollen nur aus der Datei amp GENOLD bernommen werden YES Die Systemvariablen der Benutzer sollen aus der Datei amp SYSPAR bernommen werden 51 amp SYSPAR amp GENOLD amp GENNEW amp UPDUSER amp UPDFUTAB amp UPDUSVAR U21462 J Z125 7 Generierung des AVAS Systems Installation und Generierung Beispiel Generierung einer neuen GENPAR Datei DO AVAS SYSPRC AVAS 070 AVS CREATE GENPAR REMARK BEUTZERKENNUNG DER AVAS INSTALLATION amp USERID amp USERID AVAS REMARK NAME DER DATEI URSPRUENGLICHE ALTE GENPAR amp GENOLD amp GENOLD AVAS USER GENPAR OLD REMARK NAME DER DATEI AKTUELLE SYSTEMPARA
102. Job 536 RESTART NAME 536 RESTART NET 536 BATCH Anweisung 339 Programmschnittstelle 373 RESTART SKIP CONDITION 42 RESTART SKIP ERROR 42 RESTART TYPE 536 RESTART VARIANT 536 RESTART WAIT CONDITION 43 RESTART WAIT ERROR 43 RESUME NET BATCH Anweisung 341 routing code 35 RUN CONTROL SYSTEM 536 RZ Exit AVEX0001 68 81 AVEX0002 68 81 AVEX0101 69 82 AVEX0102 69 83 AVEX0401 69 84 AVEX0402 70 87 AVEX0403 70 88 AVEX2001 71 90 AVEX6601 71 91 AVEX6602 71 93 AVEX6801 72 94 AVEX6802 72 6 AVEX7101 73 98 AVEX7102 73 99 261 EXIT Modul Zuordnung 75 555 Protokollelement Name 138 TypD 138 TypS 138 Protokollstatus bersicht 154 Protokollverarbeitung steuern 118 Prozedur AVS GENPERIOD 323 Prozesse starten 107 Steuerung Windows 476 berwachen ber Jobvariable 133 R R 3JobControl installieren 14 READ AVAS LIBRARY 373 reale Daten einer variablen Periode 323 Rechnertabelle aktualisieren 131 Registerkonventionen 76 Reorganisation Ablauf 165 Ablaufbeispiel 181 Ablaufdatei 165 AVAS Benutzerdateien 163 Journaldatei 165 Protokolldatei 166 Reorganisationsanweisung AVAS SYSTEM ID 170 AVAS USER ID 170 DELETE JOB LOG 171 DELETE PLAN NET 171 END 171 FUNKTION 172 HISTORY DELETE DATE 173 HISTORY DELETE OPTION 174 HISTORY KEEP RECORDS 175 HISTORY SAVE OPTION 176 JOBLOG DELETE DATE 176 JOBLOG DELETE STATUS 177 JOBLOG SAVE LINK 8 JOBLOG SAVE OPTION 177 NET NAME 178 OUTPUT FILE 178 OUTPUT LINK 179 PERIOD NAME 179
103. L5 L12 CL8 L2 L6 L6 L20 L3 L30 L3 HOSKEY H03H03 L10 L19 L9 L19 L4 L9 L9 L9 L9 L9 L9 L9 L9 L9 L9 L9 L6 L54 DIDI EI CI COI OIA C3 10903269 DIDI EE CC ff es DS DS DS DS DS DS DS DS DS DS DS DS EQU EQU DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS DS 2 HO HO HO HO HO EY BKR ET DTPL DTJH HO3PLSD HO3PLST HO3SYMD HO3IND H03JOB HO3FUN HO3STYP HO3KLE HO3HLE N ww CO CO GA P PA Po PA PA P P P P P HO3STT HO3RNT HO3ENT HO3RTJ HO3WTC HO3WTE HO3AZE HO3JRNS 226 Sicherung und Reorganisation Aufbau der History Datei 1 2031065 DS CL54 JOBLOG SAVE FILE 1 DS CL626 1 DS CL3044 1 HO3SLEN EQU HO3H03 LAENGE SATZ 03 U21462 J Z125 7 227 Aufbau der History Datei Sicherung und Reorganisation Definitionen KEY 04 TYP JOB FU J P X H04 AVASJRN H04 hehehe he he he he he he ee he hehe ke Kee ee SATZBESCHREIBUNG HISTORY KEY 04 AB VERS 6 0A HOA 7
104. MAREN Katalog archivierten B nder verf gbar sind und keine den Zugriff verhindernden Einschr nkungen vorlie gen F r alle B nder die unter Angabe einer Schutzfrist RETENTION PERIOD beschrieben wurden muss im MAREN Katalog die Schutzfrist mit der MAREN MARENADM Anweisung MOD VOL ATTR VOL vsn EXPIRATION DATE 0 zur ck gesetzt werden sofern sie zum Zeitpunkt des RESTART nicht ohnehin schon abgelaufen ist Zwischen dem Abbruch des Jobs und dem Restart mit MAREN MARENADM Anweisungen d rfen den B ndern im MAREN Katalog keine Attribute vergeben werden die ein erneutes Verarbeiten dieser Datentr ger verhindern dies d rfte ohnehin unwahrscheinlich sein M gliche Fehlerursachen w ren z B das Andern von VOLUME Kennw rtern das Verlagern an REMOTE Lagerorte das L schen der VSNs aus dem Volume Katalog und das Freigeben oder Ausleihen der Daten tr ger Zwischendurch sollten keine MAREN Parameter modifiziert werden die eine grundlegende nderung bei der berpr fung der Datentr ger Verf gbarkeit zur Folge haben auch unwahrscheinlich Insbesondere kritisch ist in diesem Zusam menhang der MAREN Parameter FOREIGN TAPE CHECK der anzeigt ob alle zu verarbeitenden Datentr ger im MAREN Katalog archiviert sein m ssen 2 Wiederholungslauf ber REPEAT NET Wenn ein Wiederholungslauf ber REPEAT NET durchgef hrt werden soll muss wie auch im Falle von RESTART gew hrleistet sein dass zum Ablaufzeitpunkt des
105. Namen eines RZ Exits an pfix kann ein maximal 3 stelliger Pr fix sein der dem maximal 4 stelligen Feldnamen vorangestellt werden kann Folgende Felder der Kommunikationsbereiche sind bei allen Funktionen mit den gleichen Werten versorgt Sie k nnen von der RZ Routine ge ndert werden pfixLEN Ausgabe Parameter Gesamtl nge des Kommunikationsbereichs pfixLFU Eingabe Ausgabe Parameter Lange der Daten die AVAS an die RZ Routine im Anschluss an dieses Feld bergibt Funktionsabh ngig kann die RZ Routine diese L nge andern wenn die L nge der R ckgabe unterschiedlich ist Die ge nderte L nge darf die fest gelegte Grenze des Kommunikationsbereichs nicht berschreiten Beispiel name DSECT EX7101 AVASEXKO EXITNAM EX7101 PFIX 2A71 EX7101 DS OF AVAS AVEX7101 KOMMUNIKATIONSBEREICH A71LEN DS F LAENGE KOMMUNIKATIONSBER A71LFU DS F LAENGE FUNKTIONSDATEN A71NNAM DS CL32 NETZNAME AUS NPRLIB A71EARL DS CL12 EARLIEST START A71LATS DS CL7 LATEST STAR A71LIFT DS CL7 LIFE TIME ATINTYP DS CL1 NET TYPE 8710250 DS 08 NET DELAY SOLUTION 84718057 DS 08 RUN CONTROL SYSTEM U21462 J Z125 7 80 Installation und Generierung RZ Exits im AVAS System 2 4 5 RZ Exit AVEX0001 und AVEX0002 Bevor ein Journalsatz auf Grund einer AVAS Funktion in die Journaldatei ausgegeben wer den soll ruft AVAS die RZ Routine auf Im RZ Exit AVEX0001 werden die Journals tze weiterhin im F
106. Netze in der angegebenen Arbeitsdatei OPEN EXTEND Wenn die Anweisungen NET NAME und PERIOD NAME angegeben werden werden nur die Netze ausgew hlt die beide Auswahlkriterien erf llen U21462 J Z125 7 291 OUTPUT REPORT FILE REPORT Anweisungen OUTPUT REPORT FILE Zuordnen BS2000 Dateiname f r Reportdatei Mit OUTPUT REPORT FILE wird der Reportdatei ein BS2000 Dateiname zugeordnet Diese Datei ist die Ausgabedatei f r einen zu druckenden Report Die Anweisung muss nur bei FUNKTIONZPRINT angegeben werden OUTPUT REPORT FILE full filename Dateiname gem den BS2000 Konventionen Die ber die Anweisung zugeordnete Reportdatei wird vom REPORT Generator im Modus OUTPUT EXTEND er ffnet wenn sie bereits vorhanden ist Der REPORT Generator sammelt die Daten der Reports in der angegebenen Reportdatei wenn FUNKTION PRINT mehrfach mit der gleichen Dateizuweisung aufgerufen wird Damit k nnen unterschiedliche Auswertungen einer Arbeitsdatei ber die REPORT Anwei sungen SELECT STATUS und THRESHOLD in eine Reportdatei ausgegeben werden und aus dieser mit dem BS2000 Kommando PRINT FILE gedruckt werden Das Ausgabeformat ist druckaufbereitet Parameter CONTROL CHARACTERS EBCDIC Wenn eine neue Reportdatei angelegt werden soll muss eine u U vorhandene Reportdatei vorher gel scht werden Alternativ kann die Anweisung OUTPUT REPORT LINK vorgegeben werden Wenn weder die Anweisung OUTPUT REPORT FILE noch die Anweisung OUTPUT
107. Netzes die Schutzfrist f r alle im MAREN Katalog archivierten Ausgabeb nder bereits abge laufen ist Ist dies nicht der Fall muss zuvor das EXPIRATION DATE mit der MAREN Anweisung MODIFY VOLUME ATTRIBUTES zur ckgesetzt werden Falls eine Datei in einem Job oder verteilt auf mehrere Jobs eines Netzes weiterverar beitet wird k nnen vor REPEAT NET noch andere Aktionen notwendig sein Zwei F lle sind hier zu unterscheiden Weiterverarbeiten einer Eingabedatei Weiterverarbeiten einer Ausgabedatei U21462 J Z125 7 274 Kopplung AVAS mit MAREN Erstellen von Datentr gerlisten Weiterverarbeiten einer Eingabedatei In einem Netz findet eine Dateiaktualisierung statt indem eine im jeweils zuletzt abgelau fenen Netz erstellte Banddatei eingelesen aktualisiert und auf ein neues Band zur ckge schrieben wird Die Auswahl der VSNs erfolgt mit Hilfe der Platzhalterzeichen VOL und SCR Beispiel f r diesen Job SET LOGON PARAMETERS REMAR ZUWEISEN DER BAND EINGABEDATEI IMPORT FILE SUPPORT TAPE VOLUME VOL DEVICE TYPE T6250 FILE NAME DATEIX SET FILE LINK LINK NAME IN FILE NAME DATEIX REMAR ZUWEISEN DER PLATTEN AUSGABEDATEI SET FILE LINK LINK NAME OUT FILE NAME DATEIY REMAR KOPIEREN VON DATEIX BAND NACH DATEIY PLATTE START PROGRAM FROM FILE PROGI REMAR LOESCHEN KATALOGEINTRAG VON DATEIX REMAR FRE
108. OF MULTI VOLUME HAVE DIFFERENT USERIDS Bei einer Multivolume Datei sind nicht alle VSNs im MAREN Katalog derselben Kennung zugeordnet Die Produktionsfreigabe wird abgebrochen FILE NOT CLOSED MARENAV stellte anhand des CLOSE Indikators im Archiveintrag eines Datentr gers fest dass die zugeh rige Datei bei der Erstellung nicht oder nicht ordnungsgem geschlossen wurde Wenn in der Dateizuweisung der Platzhalter VOL angegeben wurde handelt es sich um eine Eingabedatei Die Freigabe wird abgebrochen da eine sinnvolle Weiterverarbeitung nicht m glich ist Wenn MARENAV nicht feststellen kann ob es sich um eine Ein oder Ausgabedatei handelt erscheint diese Meldung nur als Warnung und die Produktionsfreigabe l uft weiter 278 U21462 J Z125 7 Erstellen von Datentr gerlisten ERROR error code DURING PROCESSING OF MACRO macro name Bei der Ausf hrung eines Makros trat der angegebene Fehler auf Die Produktionsfreigabe wird abgebrochen 6 3 8 Warnungsmeldungen von MARENAV In der von MARENAV erstellten Transport und Montierliste k nnen zu einzelnen VSNs folgende Warnungen enthalten sein die auf m gliche Fehlerquellen w hrend des Ablaufs eines Netzes hinweisen Es empfiehlt sich den Status der gekennzeichneten Datentr ger zu berpr fen Im Einzelnen handelt es sich hierbei um folgende Meldungen VOLUME EXPORTED Der angegebene Datentr ger ist ausgeliehen und muss bis zum Ablaufzeitpunkt wieder zur ckgebrach
109. Prozedur erzeugen 323 Standardwert DEFAULT CANCEL TYPE 43 DEFAULT CONDITION DELAY 39 DEFAULT CONDITION TYPE 39 DEFAULT DISPLAY DUMMY 40 DEFAULT DOC NAME 38 DEFAULT ENTER PARAMS 39 DEFAULT JOB DELAY 39 DEFAULT JOB TURNUS 38 DEFAULT JOB TYPE 38 DEFAULT JVA LENGTH 39 DEFAULT JVA POSITION 39 DEFAULT LATEST JOBSTART 39 DEFAULT LATEST NETSTART 39 DEFAULT LATEST OCCURE 40 DEFAULT LIFE TIME 39 DEFAULT MARK YES 38 DEFAULT NET DELAY 38 DEFAULT NET TURNUS 38 DEFAULT NET TYPE 38 DEFAULT OCCURE TIME 40 DEFAULT OPERATOR START 42 DEFAULT OVERWRITE JOB 40 DEFAULT OVERWRITE PRODJOB 0 DEFAULT PLAN TYPE 38 DEFAULT PROCPAR STRING 40 DEFAULT RESTART JOB 39 DEFAULT RESTART TYPE 39 DEFAULT SERVERPAR STRING 41 DEFAULT USER PARFILE 38 Netzbeschreibung definieren 38 PARAM JOURNAL OUTPUT 41 START Reorganisationsanweisung 180 Startdatei f r AVSSINCM 454 starten Ablaufsteuerung 113 AVAS DOORS 65 AVAS QUER 234 AVSRECV 474 AVSRECV AVAS Server 474 AVSSINCM AVAS Agent 463 U21462 J Z125 7 Systembibliotheken Elemente bearbeiten 8 verwalten 135 Systemdateien 53 Systemoptimierung 155 anwendungstechnische Ma nahmen 157 organisatorische Ma nahmen 155 Systemparameter ndern bei zentralen Zugriffsprozessen 45 Benutzer 27 zentrale Zugriffsprozesse 22 Systemparameterdatei verwalten 135 Systemsicherheit 104 Systemstart 104 Systemvariable der Benutzer definieren 34 T tempor re Jobs 537 tempor re Server Jobs 537 Terminplanung 2 TRA
110. Prozesse von diesen ein gerichtet Wenn die Namen der Jobvariablen mit einer BS2000 Benutzer kennung angegeben werden m ssen die ZD Prozesse unter der angegebenen Benutzerkennung zum Ablauf gebracht werden 22 U21462 J Z125 7 Generierung des AVAS Systems Installation und Generierung PASSWORD ENCRYPTION YES NO Die BS2000 Kennw rter in den Netzen werden bei CREATE PLAN NET ber CRYPT verschl sselt und im Produktionsplan NPRLIB und in der Ablaufdatei ABLDAT verschl sselt gespeichert Die Verschl sselung erfolgt im zentralen Zugriffsprozess ZDL die Entschl sselung in den Ablaufsteuerungen Die BS2000 Kennw rter in den Netzen werden nicht verschl sselt YES NO MAX BATCH PROCESS n Maximale Anzahl n von BATCH Prozessen die sich gleichzeitig bei der ZDD und ZDL anmelden k nnen Die Prozesse an der Pro grammschnittstelle m ssen dabei mit ber cksichtigt werden Die Anmeldung weiterer Prozesse wird mit einem R ckkehrcode zur ckgewiesen Sie werden in einen Wartezustand versetzt die Anmeldung wird nach einer festgelegten Wartezeit wiederholt Wenn der Parameter nicht angegeben wird wird MAX BATCH PROCESS 2 angenommen Hinweis Die Anweisungen CREATE PLAN NET CREATE PROD NET und SUBMIT NET REPEAT NET werden serialisiert siehe dazu Abschnitt Systemstart und Systemsicherheit auf Seite 104 Damit kann ein sinnvoller Wert f r MAX BATCH PROCESS berechnet werden MAX BATCH PROCESS pp bp ba b
111. RESTART VARIANT AVSNHPVS DS CL4 HOME PVS MONJV AVSNSRVN DS 0CL8 SERVER SINIX ID DS CLA AVSNCATI DS CL4 CATID JOB PROC USED FIELDS ABOUT TYPE AND FUNCTION FIELD TYPE JVAINET JOB RES VAL TIM MOD EXT STD FUNC C C D SIC DICAM DICAM DIM 1J PIJ PIJ P RSRV SEL RES VA in l l l Eoo l l l gt E 3 ES E de dp Gp LST LAST START l 1 LTS LAST START l l l l gt DATE TIME L0C LAST OCCU l l E III z LTO LAST OCCU l l l LN E 1 DATE TIME DSO DELAY SOLU in l I l l l gt 1 H 1 1 H H B veg VA VALUE MEE be do qno p OR VC VALUE CODE l plc ape Ode BM OS OCC VAL STR NES p i E sm 0 ERE OC OCC VAL COD Ir l u VE Todo ES ERR VAL STR b l E o P E EE EC ERR VAL COD l In Pj QD al HE Lo KS kA 0 TT CN CREA NET N Ir 14 E X vd pO se CI CREA INDEX I Ceo e PREFIX AVSN FU TYPE RESTART POINTS AVSNRSI1 DS CL3 RESTART 1 INDEX AVSNRSTI DS X RESTART 1 TYP AVSNRSJ1 DS CL30 RESTART 1 JOBNAME AVSNRSI2 DS CL3 RESTART 2 1NDEX AVSNRST2 DS X RESTART 2 TYP 394 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Schnittstelle AVSNRSJ2
112. RUN CONTROL SYSTEM NAME S51NSTIT DS oun NETZSTATUS 1 TEXT 5510511 DS X NETZSTATUS 1 CODE DS CL S51NST2T DS 00110 NETZSTATUS 2 TEXT 5510512 DS X NETZSTATUS 2 CODE DS CL S51NST3T DS 00110 SYSTEMINTERNER WERT NETZSTATUS 3 TEXT 5510513 DS X SYSTEMINTERNER WERT NETZSTATUS 3 CODE DS CL9 ESTART VARIANTE 1 2 3 ARLIEST START S51RVAR DS CL1 S51EARL DS CL12 m o 551158 DS CL12 LATEST START DS CL11 RESERVE S51NSHTW DS CL1 NETSTATUS CALLED FOR HOSTWAIT S5INTYP DS CL1 NET TYPE S51NDSLT DS 0CL6 NET DELAY SOLUTION TEXT S51NDSL DS X NET DELAY SOLUTION CODE DS CL5 5510251 DS 0CL3 NET OPERATOR START TEX 5511025 DS X NET OPERATOR START CODE DS CL2 S51NCDCT DS 0CL3 NET CONDITION CREATED TEXI S5INCDC DS X NET CONDITION CREATED CODE DS CL2 DS CL7 RESERVE S5INSERR DS X NETZSTATUS CALLED FOR ERROR 55111551 DS X NETZSTATUS CALLED FOR RESTART S51NSCWT DS X NETZSTATUS CALLED FOR CONDWAIT S51NSHLD DS X NETZSTATUS CALLED FOR HOLD S51NSRSU DS X NETZSTATUS CALLED FOR RESUME S51NSO EQU x 80 NETZSTATUS CALLED FOR IST GESETZT TM S51NSDA DS CL21 NETZSTATUS GEMAESS DIALOGANZEIGE 551551 EQU S51S51lA LAENGE DER DATE 5511 EQU N3JRNS U21462 J Z125 7 205 Sicherung und Reorganisation
113. RUN CONTROL SYSTEM S31 AVASJR 31 07 Ende Netzfreigabe S31 AVASJR 31 08 Abbruch der Funktion S31 AVASJR 09 05 Fehlermeldung MSG7 Text 09 06 Fehlermeldung MSG7 Text REPEAT NET 31 00 Start Netzfreigabe S31 AVASJR 32 00 Ausgabe Strukturelement mit S32 AVASJR x FU J P X 32 05 Ausgabe Strukturelement mit S32 AVASJR x FU J P X Error 25 01 JCL Anweisung alt Anweisung JMDLIB x 25 02 JCL Anweisung neu Anweisung EX7102 x 25 04 JCL Anweisung l schen Anweisung JMDLIB x 25 05 JCL Anweisung Error Anweisung EX7102 x 25 09 JCL Anweisung ERROR EXIT Anweisung EX7102 x 54 00 Ausgabe Strukturelement mit S54 AVASJR x FU A C D M W 54 04 L schen Strukturelement mit S54 AVASJRN x FU A C D M W 31 02 Wechsel RUN CONTROL SYSTEM S31 AVASJR 31 07 Ende Netzfreigabe S31 AVASJR 31 08 Abbruch der Funktion S31 AVASJR 09 05 Fehlermeldung MSG7 Text 09 06 Fehlermeldung MSG7 Text U21462 J Z125 7 194 Datenstrukturen Journalsicherung Not Journaldatei 195 Ausgabe im Datenbereich RN RN RN RN RN RN RN RN RN RN RN RN RN RN RN RN RN RN RN RN RN RN AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ AVASJ 551 551 551 MSG7 Text S51 552 552 551 S51 MSG7 Text S51 S52 552 551 S51 MSG7 Text S51 S51 S51 MSG7 Text S51 552 552 S58 S51 S51 MSG7 Text Sicherung und
114. S 003 ausgegeben ALL Beim Start der Modifikation eines Netzes ber die Anweisung CREATE PROD NET wird eine Liste aller Parameter aus der USER PARAM FILE mit dem Satzschl ssel 21 01 ausgegeben Zus tzlich werden die Werte der Systemvariablen S 001 S 002 und S 003 ausgegeben Die Journals tze 25 01 und 25 02 werden f r jeden modifizierten Satz aus gegeben NO Die Parameter und die Modifikation werden nicht protokolliert Definition von Standardwerten f r die Netzfreigabe DEFAULT OPERATOR START YES NO Standardwert f r den Parameter OPERATOR START in den Masken AVF002 und AVF012 der Anweisungen SUBMIT NET und REPEAT NET Definition von Werten f r die Restart Verarbeitung Wenn ein Wert nicht beschrieben wird wird der unterstrichene Wert angenommen Die Werte RESTART SKIP ERROR und RESTART SKIP CONDITION beschreiben das Verhalten der Operation RESTART NET wenn durch die gew hlte Restart Variante ein Teil des Netzes nicht mehr zum Ablauf kommen soll RESTART SKIP ERROR YES NO YES Strukturelemente im Status ERROR d rfen in den Status SKIPPED gesetzt werden NO Der Restart wird zur ckgewiesen wenn ein Strukturelement vom Status ERROR in den Status SKIPPED gesetzt werden muss Ausgenommen ist das Strukturelement im POINT OF ERROR RESTART SKIP CONDITION YES NO YES Bedingungen im Status NO OCCURE oder WAITING d rfen in den Status SKIPPED gesetzt werden NO Der Restart wird zur ckgewiesen wenn eine Be
115. S54SY DS CL3 SYNC INDEX S5ALATS DS CL12 LATEST START OCCURE OCCURE TIME S54DSLT DS 0CL6 DELAY SOLUTION TEXT S54DSL DS X DELAY SOLUTION CODE DS CL5 S54JRSP DS 3CL48 RESTART PUNKTE ORG S54JRSP S54RSV DS 0CL48 RESTART VARIANTE 1 S54RS DS CL3 RESTART INDEX V1 S54RSY DS CL30 RESTART NAME V1 DS CL2 RESERVE 55485111 DS 0CL10 RESTART TYP V1 TEXT S54RST DS X RESTART TYP V1 CODE DS CL9 55485811 DS CL3 AUTOMATIC YES NO TEXT S54RSV2 DS 0CL48 RESTART VARIANTE 2 5548512 DS CL3 RESTART INDEX V2 S54RSJ2 DS CL30 RESTART NAME V2 DS CL2 RESERVE S54RST2T DS 0CL10 RESTART TYP V2 TEXT 5548512 DS X RESTART TYP V2 CODE DS CL9 S54RSA2T DS CL3 AUTOMATIC YES NO TEXT S54RSV3 DS 0CL48 RESTART VARIANTE 3 5548513 DS CL3 RESTART INDEX V3 S54RSJ3 DS CL30 RESTART NAME V3 DS CL2 RESERVE S54RST3T DS 0CL10 RESTART TYP V3 TEXT 5548513 DS X RESTART TYP V3 CODE DS CL9 S54RSA3T DS CL3 AUTOMATIC YES NO TEXT DS CL3 RESERVE S5ASELRV DS C SELECT RESTART VARIANT S54554L EQU S54854A LAENGE DER DATEN S54LEN EQU N3JRNS 208 U21462 J Z125 7 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Definitionen Satzschl ssel 55 ERSETZT SATZSCHLUESSEL 63 AB VERSION 02 0A N3INH ORG AVASJRN 55
116. SIGNAL und TRANSFER Der Parameter steuert das L schen von Protokolldateien nach einer fehlerfreien ber tragung durch TRANSFER Wenn der Parameter weder bei SIGNAL noch bei TRANSFER angegeben wird gilt der Standardwert der beim Starten des CENTRAL Prozesses angegeben wurde Wenn der Parameter bei SIGNAL nicht angegeben wird wird der Standardwert des CENTRAL Prozesses gesetzt Wenn der Parameter bei TRANSFER angegeben wird wird der bei SIGNAL gesetzte Wert damit berschrieben OptimierungsmaBnahmen f r das Sammeln der Protokolle Wenn das bisher angewandte Protokollsammeln zufrieden stellend l uft ist keine nde rung vorzunehmen Wenn jedoch die bertragung gro er Protokolldateien erforderlich ist kann das bisherige Verfahren zu langen Laufzeiten f hren In diesem Fall ist eine Beschleu nigung des Protokollsammelns durch die Ma nahmen im oberen Teil der folgenden Matrix moglich Protokolldatei f r CENTRAL lesbar machen Y Y NN LOGSYS Bibliothek f r CENTRAL beschreibbar machen Y N Y N A CENTRAL liest die JOBLOG Dateien direkt X X Protokoll wird von TRANSFER gelesen und mit DCAM nach CENTRAL gesendet x x B CENTRAL schreibt direkt in die LOGSYS Bibliothek X X CENTRAL sendet Protokoll zum Schreiben mit ITC an die PLAM ZD X X schnellstes Verfahren xX aufw ndigstes Verfahren X Auswirkung von A Da CENTRAL auf die Protokolldatei zugreifen kann OPEN INPUT SAM ISAM entf llt die Datei
117. START Modus AVSSINCM hat Verbindung zu AVSSTHT der von AVSSINCM mit der Bearbeitung des Server Jobs beauftragt wurde Q QUERY Modus AVSSINCM hat die Verbindung zum urspr nglichen AVSSTRT verloren und ber einen neuen Partner das Ende des Server Jobs ermittelt T TRANSFER Modus F r einen BS2000 Server Job wird auf dem entfernten BS2000 System ein TRANSFER Folgejob gestartet C CANCEL Modus Ein gestarteter Server Job soll abgebrochen werden Byte 208 Hostname des Server Rechners 16 Zeichen Die ersten 16 Zeichen des Rechnernamens oder seine IP Adresse Byte 224 Sserver name 8 Zeichen 470 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs 11 3 4 Ablaufsteuerung und kontrolle f r UNIX Systeme Zum Starten und berwachen von Jobs auf UNIX Systemen wird der AVAS Server AVSRECV angeboten BS2000 OSD UNIX System Ablauf steuerung Server Job ENTER PROC AVSSINCM 4 Konf datei A Socket 0 gt AVSRECV Server Verbindungsaufnahme Job fork nach Auf tragseingang socket gt AVSSTRT Ss AVSSTRT SYSTEM Server Job Server Job Bild 7 Architektur und Kommunikation BS2000 OSD UNIX System Der AVAS Server AVSRECV wird vom Administrator des UNIX Systems gestartet er l uft unabh ngig von AVAS an Er richtet einen TCP Stream Socket ein und wartet als concur rent Server auf
118. Server Jobs i Aufbau der Konfiguralionsdatel aan axe m v EROR ERR NEE Starten des AVAS Agenten AVSSINCM esses nn Aufbau der Auftrags Jobvariable und der Server JV Datei LL Ablaufsteuerung und kontrolle f r UNIX Systeme Starten des AVAS Servers AVSRECV i Beenden des AVAS Servers AVSREOV i bergabe der Parameter an Server Jobs f r UNIX Plattform Starten von Programmen aus Server Jobs auf UNIX Systemen Ablaufsteuerung und kontrolle f r Windows Systeme Starten des Dienstes AvasService auf Windows Systemen Beenden des Dienstes AvasService auf Windows Systemen Anzeigen und ndern der Ablaufparameter des Windows Dienstes AvasService Schnittstelle von AVAS SV zur Benutzerverwaltung auf Windows Systemen bergabe der Parameter an Server Jobs f r Windows Plattform Starten von Programmen aus Server Jobs auf Windows Systeme Ablaufsteuerung und kontrolle f r entfernte BS2000 Systeme Starten des AVAS Servers unter BS2000 0SD i Beenden des AVAS Servers unter BS2000 0SD ii Prozess Server berwachung nitie 4 nn Programme des AVAS Servers auf Windows und UNIX Systemen AVSSINJV Modifizieren der Auftrags Jobvariable AVSLOG Zuordnung d
119. Steuerung des Ablaufs ber SYSDTA vorgegeben Die Standardwerte dieser Steuerungs Parameter sind so gew hlt dass mit einfachen Mitteln Daten f r ein Protokoll gesammelt werden k n nen Zudem bieten diese Parameter die M glichkeit weitere SAM oder ISAM Dateien in den zentralen AVAS Pool zu bertragen um eine m glichst vollst ndige und revisions Sichere Auftragsproduktion im Rechenzentrum durchf hren zu k nnen Hinweise f r die Steuerungs Parameter e FILE NAME beim Programm TRANSFER Der Parameter wird nur ben tigt wenn nur ein bestimmtes Protokoll gesammelt werden soll obwohl mehrere Protokolle signalisiert wurden Durch die Angabe eines Namens l sst sich eine 1 zu 1 Beziehung zwischen SIGNAL und TRANSFER herstellen Der Wert LAST erm glicht eine Steuerung des Ablaufs nach dem Prinzip last in first out wobei auch ein Fehler beim Programm TRANSFER das Prinzip erf llt Wenn das Programm TRANSFER von der Ablaufsteuerung als Folgejob gestartet wird wird stets FILE NAME ALL angenommen e TRANSFER OPTION beim Programm SIGNAL Die bertragung der Protokolle die ber SIGNAL in einem AVAS Job signalisiert wur den kann durch den Aufruf von TRANSFER im AVAS Job erfolgen oder durch den Start eines Folgejobs mit TRANSFER durch die Ablaufsteuerung Im Regelfall pr ft die Ablaufsteuerung ob TRANSFER im AVAS Job gestartet wurde Sie startet einen Fol gejob wenn TRANSFER nicht aufgerufen wurde Diesen Folgejob brau
120. Systembibliothek f r die Dokumentation der Netze LOGSYS Schl sselwort der Systembibliothek f r die Protokolldaten U21462 J Z125 7 27 Generierung des AVAS Systems Installation und Generierung Elemente mit dem Systembenutzerkreis werden nur in den Bibliotheken JCLSYS NETSYS bzw JMDSYS gesucht Elemente mit einem anderen Benutzerkreis k nnen in diesen Bibliotheken ber AVAS Funktionen nicht bearbeitet werden Die Bearbeitung der Elemente in den Systembibliotheken erfolgt mit folgenden Anwei sungen Anweisung INPUT LIB OUTPUT LIB COPY SYSTEM ELEMENT NETLIB NETSYS oder JCLLIB JCLSYS oder JMDLIB JMDSYS oder DOCLIB DOCSYS DELETE SYSTEM ELEMENT NETSYS oder JCLSYS oder JMDSYS oder DOCSYS ADD JOB LOG LOGSYS DELETE JOB LOG LOGSYS CREATE PLAN NET NETSYS NPRLIB CREATE PROD NET JCLSYS JMDLIB CREATE PROD JOB JCLSYS JMDLIB SUBMIT NET JMDSYS ABLDAT REPEAT NET JMDSYS ABLDAT Die Elemente aus den Systembibliotheken k nnen mit folgenden Anweisungen ange zeigt werden wobei f r den Zugriff auf diese Bibliotheken eine Berechtigung vorhan den sein muss Anweisung INPUT LIB SHOW JOB JCLSYS SHOW NET DESCRIPTION NETSYS SHOW PROD JOB JMDSYS SHOW DOCUMENT DOCSYS Die Elemente aus der Systembibliothek LOGSYS k nnen mit der Anweisung SHOW JOB LOG angezeigt werden F r diese Anweisung kann eine Funktionsberechtigung des Normalbenutzers oder eine Berechtigung erteilt werden U21462 J Z125 7 2
121. TEMP LOC DA12ZEO2 STE MOD VOL ATTR VOL Y1B003 TEMP LOC CPUO03 END ENDP TEMP LOC gibt den Lagerort an wohin die Datentr ger gebracht werden sollen 272 U21462 J Z125 7 Kopplung AVAS mit MAREN Erstellen von Datentr gerlisten 6 3 4 Einschr nkungen von MARENAV Die genannten Funktionen von MARENAV werden nur aktiviert wenn VSNs in einem der auf Seite 259 erw hnten DVS Kommandos CREATE FILE usw vorkommen In folgenden F llen leitet MARENAV keine Aktionen ein e VSNs werden im BS2000 Kommando SECURE RESOURCE ALLOCATION angege ben e VSNs kommen in Programmanweisungen vor e VSNs sind durch Werte von Jobvariablen zu ersetzen e VSNs werden in Prozedurvariablen angegeben e VSNs werden in einer Prozedur angesprochen die innerhalb eines Jobs ber das BS2000 Kommando CALL PROCEDURE gestartet wird e Im DVS Kommando SET FILE LINK werden bei Angabe des Parameteres TAPE SET NAME die in den TST Eintr gen enthaltenen VSNs nicht berpr ft e Der Parameter START POSITION wird im Zusammenhang mit den Verf gbarkeitspr fungen nicht ausgewertet d h es werden immer alle VSNs einer katalogisierten Band datei berpr ft unabh ngig von der beim Parameter START POSITION getroffenen Auswahl Wenn eine Datei in einem Netz mehrmals angesprochen wird findet nur beim ersten Mal eine berpr fung der Datentr ger statt Die in weiteren Zuweisungen f r diese Datei zu s tzlich vorkommenden VSN
122. Userid auf dem Server System AVS SVDOG JV Name der Jobvariablen die den SVDOG berwacht U21462 J Z125 7 467 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung Hinweise e Beachten Sie bitte dass auf keinen Fall die restlichen Anweisungen f r AVSSINCM ge ndert werden d rfen andere Anweisungen f r AVSSINCM eingef gt oder vorhandene gel scht werden d rfen e Eine AVJ Anweisung nach der END Anweisung in der Anweisungsfolge f r AVSSINCM berschreibt Eintr ge die der Server Job gemacht hat e Die Startparameter f r AVSSINCM m ssen immer ausgeschrieben werden e Wenn SERVER NAME STD angegeben ist m ssen die Parameter f r AVSSINCM in dessen Startprozedur enthalten sein Wenn SERVER NAME STD nicht angegeben ist muss das Programm AVSSINCM Zugriff auf die Konfigurationsdatei haben Dabei ist zu beachten dass die Konfigura tionsdatei selbst wegen der darin enthaltenen Kennw rter schutzw rdig ist e Wenn ein Parameter in Hochkommata angegeben wird um ihn in einer Prozedur mit Kleinbuchstaben definieren zu k nnen z B DECL PARAM AVS DEF USER ID INIT user entfernt AVSSINCM die begrenzenden Hochkommata Hochkommata innerhalb eines Textes werden nicht ver ndert e DerSchalter SKIP COMMANDS TO LABEL SW29SET wird von AVSSINCM gesetzt wenn es sich um einen BS2000 Server Job handelt Der Schalter bewirkt dass die Pro gramme SIGNAL und TRANSFER nicht aufg
123. YES Es werden die Equates f r die Schl sselw rter generiert Hinweis Der Makro AVSASSCE generiert eine Verl ngerung des Ausgabebereichs Er muss daher im Anschluss an den Makro AVSASSBO aufgerufen werden U21462 J Z125 7 409 Assembler Schnittstelle Programmschnittstelle von AVAS Aufl sung des Makros AVSASSCE AVSASSCE MFCHK MF C PREFIX A MACID VSB DMACID VSB SUPPORT C D DS OF PREFIX A MACID VSB JA ABLDAT CONDITION DESCRIPTION AVSBACON DS 0CL192 DS CL2 RESERVED AVSBCCR DS OCL12 CREATION DATE AVSBCCRD DS CL6 CREATION DATE DATE YYMMDD AVSBCCRT DS CL6 CREATION DATE TIME HHMMSS AVSBCTXT DS CL120 CONDITION TEXT AVSBCDOC DS CL43 DOCUMENT ELEMENTNAME AVSBCLU DS 0CL12 LAST UPDATE AVSBCLUD DS CL6 LAST UPDATE DATE YYMMDD AVSBCLUT DS CL6 LAST UPDATE TIME HHMMSS DS CL2 RESERVED ORG AVSBACON AVSBCVAL DS XL128 VALUE X STRING BY TYP VAL DS CL64 ORG AVSBACON AVSBNNAM DS CL32 BK NETNAME PLANSTARTDATE PLANSTARTTIME AVSBCIND DS CL3 CONDITION INDEX AVSBCWUD DS CL6 AITING OR USING DATE YYMMDD AVSBCWUT DS CL6 AITING OR USING TIME HHMMSS AVSBSTUS DS X STATE WAITING USING OCCURRED FREE AVSBENWT EQU 25 NET IS WAITING ET JOB VAL AVSBENCO EQU 155 CONDITION OCCURRED ET JOB VAL AVSBENUF EQU 117 ET IS NOT USING RESOURCE AVSBENUS EQU 118 ET IS USING RESOURCE SHARE AVSBENUE EQU 119 ET IS USING RESOURCE EXCLUSIV AVSBCOCO DS 12XL1 W
124. beschrieben 4 1 Reorganisation der AVAS Benutzerdateien Die Reorganisation der Dateien umfasst in erster Linie die Bereinigung der Best nde in der Ablaufdatei ABLDAT und in der Journaldatei JRNDAT Wahlweise k nnen die Best nde in den Bibliotheken des Produktionsplans NPRLIB und JMDLIB und der Protokollsamm lung LOGSYS reorganisiert werden Dateien die beim Reorganisationslauf wahlweise reorganisiert werden JMDLIB Bibliothek der Produktionsjobs LOGSYS Bibliothek der Protokolldaten NPRLIB Bibliothek der Produktionsnetze Dateien die beim Reorganisationslauf nicht ber cksichtigt werden CALLIB Kalenderbibliothek DOCLIB Bibliothek der Dokumentationen HSTSYS Datei mit Netz und Jobdaten die beim Reorganisationslauf beschrieben wird JCLnnn Bibliothek der Jobs und JCL Bausteine MAPnnn Bibliothek der Maskenmodule NETnnn Bibliothek der Netzbeschreibungen PERDAT ISAM Datei mit den definierten Perioden U21462 J Z125 7 163 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation Die nicht mehr ben tigten Elemente dieser Dateien m ssen durch die zugeordneten Anweisungen DELETE kontrolliert und gel scht werden Durch den Benutzer ist die Belegung des Speicherplatzes zu berwachen und gegebenenfalls zu komprimieren Dies gilt auch f r die wahlweise reorganisierbaren Dateien wenn sie beim Reorganisa tionslauf nicht ber cksichtigt wurden Die Reorganisation erfolgt mit der Reorganisationsp
125. bez glich EARLIEST START e die sp teste Startzeit LATEST START der Netze bezogen auf die geplante Startzeit im Netznamen e eine gegebene Versp tung bez glich LATEST START e die tats chliche Startzeit der Netze wenn sie bereits gestartet wurden e der Zeitpunkt der normalen Beendigung der Netze wenn sie das normale Ende bereits erreicht haben e die Auftr ge der Netze die sich im Ablauf mit Fehler beendet haben auch wenn das Netz nach einem Restart das normale Ende erreicht hat F r die Auswertung k nnen die Daten der Netze nach unterschiedlichen Kriterien sortiert werden Sortiert werden kann nach den Feldern e globaler Status der Netze e Netzname e Versp tung in Bezug auf EARLIEST START und e EARLIEST START Die Menge der in eine Reportdatei auszugebenden Netze kann durch die Vorgabe von Aus wahlkriterien eingeschr nkt werden Auswahlkriterien sind e der globale Status der Netze und e das berschreiten einer vorzugebenden Versp tung Ausgegeben wird jeweils die Schnittmenge der Netze die beide Auswahlkriterien erf llt Dabei kann eine Datei mehrfach nach unterschiedlichen Kriterien ausgewertet werden U21462 J Z125 7 282 AVAS Reports Jeder Auswertung ist eine Zusammenstellung mit den Summen aller Netze im globalen Status angef gt die auch den Prozentsatz der Netze in den vorgegebenen Zust nden aus weist Nachfolgend werden alle eingegebenen REPORT Anweisungen aufgelistet Dabei i
126. dass der kritische Punkt bei der Anweisung SUBMIT NET liegt Eine Verbesserung des Antwortzeitverhaltens und des Durchsatzes bei allen Anweisungen kann erwartet werden wenn diese Anweisung von den anderen Anwei sungen weitgehend entkoppelt ausgef hrt wird Ein entsprechendes organisatorisches Konzept ist zu empfehlen Es sei noch darauf hingewiesen dass diese berlegungen nur f r die Produktionsfreigabe einer gr eren Menge von Netzen gilt und nicht f r die einzelner Netze 156 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb Anwendungstechnische Um ein optimales Antwortzeitverhalten und einen optimalen Durchsatz zu erreichen sollte der AVAS Benutzer die folgenden Regeln so weit als m glich einhalten e Ein Job sollte im Durchschnitt nicht aus mehr als 50 100 Kommandos bestehen e Ein Netz sollte im Durchschnitt nicht aus mehr als 20 40 Jobs bestehen e REMARK oder WRITE TEXT Kommandos in den Jobs k nnen bei den AVAS Jobs auf ein Minimum reduziert werden e Anweisungen die lediglich der Dokumentation dienen sollten in Dokumentationsele mente f r die Jobs ausgelagert werden e Alle ber die Netze zum Ablauf gebrachten Jobs die nicht der Modifikation unterliegen und in denen keine AVAS Restart Anweisungen vorhanden sind k nnen au erhalb des AVAS Systems gef hrt werden Bearbeitung ber EDT unter AVAS m glich wenn im Netz JOB TYPE EXT angegeben wird Dadurch werden di
127. dem der betroffene Job bersprungen wird und damit den Status SKIPPED erreicht dann l scht AVAS die JV Datei und die Skriptdatei im Server System nicht Deshalb muss sie der Anwender l schen Der Anwender kann alle JV und Skriptdateien l schen deren zugeordnetes nde rungsdatum lter ist als der R ckstand in der ber AVAS abgewickelten Produktion Alle JV und Skriptdateien k nnen gel scht werden wenn unter AVAS keinem Netz der Status ERROR zugeordnet ist und auf dem Server System kein AVAS SERVER Agent AVSRECYV gestartet wurde Server Job Der Server Job Strukturelement mit FUNCTION X wird als Shell Skript vom Benutzer erstellt und entweder als Job Element in AVAS aktualisiert TYPE STD MOD oder als Skriptdatei im Server System TYPE EXT U21462 J Z125 7 473 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung 11 3 4 1 Starten des AVAS Servers AVSRECV Der AVAS Server AVSRECV wird auf dem Server System folgenderma en gestartet etc rc2 d S99avas kennung start Hinweise e Prinzipiell gen gt es einen Server AVSRECV zu starten um Server Jobs von verschie denen AVAS Installationen unter verschiedenen Server Benutzerkennungen laufen zu lassen Allerdings muss AVSRECV dazu privilegiert laufen d h unter der Superuser Kennung Wenn das nicht sein soll muss AVSRECV f r jede gew nschte Server Be nutzerkennung mit unterschiedlicher Portnummer gestartet werden Die Portnumm
128. den vorgegebenen Status gel scht HISTORY Mit dieser Funktion werden Datens tze in der History Datei gel scht TYP NET und JOB bzw aktualisiert TYP SUM Beim L schen bzw Aktualisie ren werden die Parameter NET NAME HISTORY DELETE OPTION HISTORY DELETE DATE und HISTORY KEEP RECORDS ber cksichtigt Die Auswahl der zu verarbeitenden S tze erfolgt ber den Parameter HISTORY DELETE OPTION Das L schen der Datens tze mit KEY 03 und 04 erfolgt ber die Parameter HISTORY DELETE DATE und oder HISTORY KEEP RECORDS in Verbin dung mit NET NAME Die komprimierten Datens tze mit KEY 01 und 02 werden gel scht wenn in den S tzen kein Ablauf mehr eingetragen ist Anzahl 0 Wenn HISTORY DELETE DATE angegeben ist werden nur S tze mit PLAN START ausgew hlt und nur diejenigen gel scht deren PLAN START vor dem vorgegebenen Datum liegt ber HISTORY KEEP RECORDS wird vorgegeben wieviele S tze jeweils in der History Datei verbleiben sollen HISTORY DELETE DATE Die Reorganisationsanweisung legt fest dass die History S tze des Netzes die bis zu einem bestimmten Tag oder innerhalb des angegebenen Zeitraums geplant wurden aus der History Datei gel scht werden sollen Wenn davon auch Netze betroffen sind die in den komprimierten Datens tzen enthalten sind werden die Daten des Netzes auch in den komprimierten S tzen gel scht und die Mittelwerte die Spannweite und die Standard abweichung neu berechnet Beim L schen wird
129. der Parameter HISTORY DELETE OPTION ber cksichtigt wenn STD NET oder JOB angegeben wurde HISTORY DELETE DATE period tt mm jj tt mm jj tt mm jj period Symbolischer Name einer Periode Die Datens tze NET und JOB von Netzen deren PLAN START in den Datumsgrenzen der Periode liegt werden in der History Datei gel scht Die Datens tze SUM werden entsprechend aktualisiert Beim L schen bzw Aktualisieren werden die Parameter NET NAME und HISTORY DELETE OPTION ber cksichtigt U21462 J Z125 7 173 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation Hmm Die Datens tze NET und JOB von Netzen mit einem lteren PLAN START werden in der History Datei gel scht Die Datens tze SUM werden entspre chend aktualisiert Beim L schen bzw Aktualisieren werden die Parameter NET NAME und HISTORY DELETE OPTION ber cksichtigt tt mm jj tt mm jj Die Datens tze NET und JOB von Netzen deren PLAN START in den angegebenen Zeitraum f llt werden in der History DAtei gel scht Die Datens tze SUM werden entsprechend aktualisiert Beim L schen bzw Aktualisieren werden die Parameter NET NAME und HISTORY DELETE OPTION ber cksichtigt HISTORY DELETE OPTION Die Reorganisationsanweisung bestimmt welche Datens tze der History Datei gel scht werden sollen HISTORY DELETE OPTION STD JOB STD Die Datens tze NET und JOB werden in der History Datei gel scht Die Datens tze SUM werden entsprechend aktualisie
130. der letzten 64 Ablaufe gespeichert Die Mittelwerte die Spannweite und die Standard abweichung werden aus den maximal 64 hier gespeicherten Zeiten berechnet U21462 J Z125 7 214 Sicherung und Reorganisation Aufbau der History Datei In der HISTORY Datei k nnen nur die S tze mit KEY 03 und 04 ber den Parameter HISTORY DELETE DATE reorganisiert gel scht werden Die komprimierten S tze mit KEY 01 und 02 werden gel scht wenn in den S tzen keine Laufzeiten mehr gespeichert sind Anzahl 0 Schl ssel der History Datei POS 5 LEN 90 Name Wert L nge von Stelle bis Stelle KEY 01 02 03 04 2 5 6 USER GROUP bk 5 7 11 NET NAME net n 12 12 23 PLAN START DATE YYYYMMTT 8 24 31 PLAN START TIME hhmmss 6 32 37 SYMDAT NAME SYMD 20 38 57 INDEX index 3 58 60 JOB NAME bk_job n 30 61 90 FU N J P X 1 91 91 TYP SUM NET JOB 3 92 94 Die Datens tze der History Datei kann der Anwender mit eigenen Programmen lesen Dazu muss er die Datei mit den Parametern SHARUPD YES und OPEN Modus INPUT er ffnen Die Satzbeschreibungen werden ber den Makroaufruf AVASJRN aufgerufen In den Datens tzen der zum Ablauf gebrachten Jobs KEY 04 kann der Anwender dem Ablauf zugeordnete Daten wie die verbrauchte CPU Zeit und die I O Rate speichern Wenn entsprechende Daten in der HISTORY Datei gespeichert werden sollen muss der Anwen der diese Werte ber die AVAS Anweisung AVA H01 an AVAS bergeben
131. des Netzes ndert wird der Wert des Parameters RUN CONTROL SYSTEM in der Netzbeschreibung auf STD gesetzt ALL Die Benutzer dieses Benutzerkreises d rfen den Namen der hier definierten Standardablaufsteuerung oder eine andere im System definierte Ablaufsteuerung verwenden Die Angabe avak use wird in den Dialogfunktionen SHOW SYSTEM PARAMS bzw MODIFY SYSTEM PARAMS nicht angezeigt und kann nicht ge ndert werden U21462 J Z125 7 29 Generierung des AVAS Systems Installation und Generierung server name Identifikationsname des Servers maximal 8 Zeichen siehe Server Konfigurationsdatei name 1 8 Server Name gem Konfigurationsdatei STD Der Server Name wird in der Netzbeschreibung selbst oder in der Startprozedur des AVSSINCM angegeben NONE Angeh rige dieses Benutzerkreises d rfen Server Rech ner ber AVAS nicht nutzen Die Angabe server name wird in den Dialogfunktionen SHOW SYSTEM PARAMS bzw MODIFY SYSTEM PARAMS nicht ange zeigt und kann nicht ge ndert werden BK bk Definition weiterer Benutzerkreise Die Zuordnung der Bibliotheken des Kalenders und der Ablaufsteuerung zu den Benutzer kreisen kann im laufenden AVAS Betrieb ber die Anweisung MODIFY SYSTEM PARAMS ge ndert werden Definition der Benutzer Mit USER werden f r AVAS die Benutzer definiert Identifikation Kennwort und die Berech tigung zu Anweisungen werden festgelegt USER avuser password bk FUTABnnn break password vi
132. die Berechtigung f r die Anweisung SHOW SYSTEM PARAMS haben Wenn alle Netze des AVAS Systems reorganisiert werden sollen wird die Anweisung nicht angegeben Die Anweisung wird nur mit USER PASSWORD C string verarbeitet AVAS USER ID string string AVAS Benutzerkennung 170 U21462 J Z125 7 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien DELETE JOB LOG Diese Reorganisationsanweisung bestimmt ob beim Ablauf der Funktion JOBLOG die Protokolle in der LOGSYS Bibliothek gel scht werden oder nicht Die Anweisung darf nur f r die Funktion JOBLOG gegeben werden DELETE JOB LOG YES NO YES Alle Protokolleintr ge die durch die Reorganisationsanweisung JOBLOG DELETE DATE oder JOBLOG DELETE STATUS gekennzeichnet sind werden gel scht Wenn beide Anweisungen nicht gegeben sind werden alle Protokolle mit Status SAVED gel scht NO Protokolleintr ge werden nicht gel scht DELETE PLAN NET Die Reorganisationsanweisung gibt an ob geplante Netze im Produktionsplan gel scht werden sollen wenn sie aus der Ablaufdatei entfernt werden DELETE PLAN NET YES NO YES Wenn die Reorganisation geplante Netze aus der Ablaufdatei l scht wer den sie auch im Produktionsplan entfernt wenn sich daf r ein Zugriffspfad ermitteln l sst Jedem Benutzerkreis dessen Netze reorganisiert werden muss mindes tens ein Benutzer zugeordnet sein NO Geplante Netze werden nicht aus dem Produktionsplan NPRLIB en
133. die Festlegung Vorbereitung und berwachung der Produktion zentral von AVAS auf einem BS2000 System durchgef hrt U21462 J Z125 7 1 Kurzbeschreibung des Produkts Einleitung 1 1 Kurzbeschreibung des Produkts Mit AVAS kann das Rechenzentrum seine Auftragsproduktion automatisieren und die not wendigen Planungs Vorbereitungs und Kontrollaufgaben im Dialog abwickeln Dezentra lisierungsans tze wie die Verlagerung der Arbeitsvorbereitung in die Fachabteilungen werden dabei genauso unterst tzt wie die zentrale Informationssammlung zu Auftr gen In der Netzbeschreibung werden die Anordnung der Jobs im Netz Terminvorgaben Job charakteristika Restart Varianten und Abh ngigkeiten definiert Es k nnen Abh ngig keiten zu anderen Netzen und Jobs sowie von Bedingungswerten und von Betriebsmitteln beschrieben werden Gruppen von Netzen und Jobs k nnen zu einem Hypernetz zusam mengefasst werden In der Terminplanung werden Kalender mit symbolischen Daten bzw Verfahrensnamen eingef hrt die zusammen mit den Netzbeschreibungen einen Produktionsplan ergeben In der Produktionsvorbereitung k nnen die Netze aus dem Produktionsplan ber Benutzer masken oder aus Parameterdateien mit Ablaufparametern versorgt werden W hrend der Produktionsfreigabe k nnen durch Zugriff auf den MAREN Katalog Trans portlisten und Bandmontierlisten f r die ben tigten Datentr ger erstellt werden Nach der Produktionsfreigabe wird das Netz
134. durch den Parameter stdout spezifizierte Datei gel scht Die Datei die mit dem Parameter stderr spezifiziert wurde kann mit dem Para meter rmerr gel scht werden Der Parameter rmall veranlasst den Server beide Dateien zu l schen Das L schen der Protokolldateien kann auch nachtr glich durch folgende Aufrufe ange geben werden avslog rmout avslog rmerr avslog rmall Der Zugriffspfad zum Verzeichnis in dem die Datei avslog exe abgelegt ist muss im Job nicht vorgegeben werden da die Datei im selben Verzeichnis wie avsrecv exe installiert wurde f r das eine path Variable gesetzt ist U21462 J Z125 7 493 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung 11 5 Steuerung von Jobs f r mySAP com mit AVAS Programm avasr3 bersicht Als Erweiterung der Funktionen der AVAS Server Schnittstelle AVAS SV wurde das Pro gramm avasr3 entwickelt das Jobs f r mySAP com ber Standard Schnittstellen von mySAP com definieren starten und berwachen kann avasr3 wird innerhalb eines UNIX bzw Windows Jobs durch AVAS SV angesto en ber Parameter wird vorgegeben wel ches ABAP 4 Programm bzw welches Programm au erhalb von mySAP com in dem Job ablaufen soll Im BS2000 AVAS ist ber den Namen und die Parameter des UNIX bzw Windows Jobs ersichtlich um welchen Job f r mySAP com es sich handelt Der UNIX bzw Windows Job wird ber die Kommunikation zwischen AVAS und AVAS SV auf die Ziel
135. eine S Prozedur oder ein Server Job mit dem Status RUNNING von der Ablaufsteuerung den Status ENDED ABENDED oder ERROR in der Ablaufdatei erhal ten hat ruft AVAS die RZ Routine auf Bei diesem einmaligen Aufruf werden folgende Informationen bergeben abweichend von den im Verst ndigungsbereich beschriebenen Feldern pfixUSR X 40 kein AVAS Benutzername pfixBKR X 40 kein AVAS Benutzerkreis pfixCAL X 40 kein Kalendername Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie folgt pfixNNAM Ausgabe Parameter Netzname pfixJIND Ausgabe Parameter Job Index pfixJNAM Ausgabe Parameter Jobname pfixJSTA Ausgabe Parameter Jobstatus pfixRV11 Ausgabe Parameter Restart Variante 1 Restart Index pfixRV1T Ausgabe Parameter Restart Variante 1 Restart Typ pfixRV1J Ausgabe Parameter Restart Variante 1 Restart Name pfixRV2l Ausgabe Parameter Restart Variante 2 Restart Index pfixRV2T Ausgabe Parameter Restart Variante 2 Restart Typ pfixRV2J Ausgabe Parameter Restart Variante 2 Restart Name pfixRV3l Ausgabe Parameter Restart Variante 3 Restart Index U21462 J Z125 7 88 Installation und Generierung RZ Exits im AVAS System pfixRV3T Ausgabe Parameter Restart Variante 3 Restart Typ pfixRV3J Ausgabe Parameter Restart Variante 3 Restart Name pfixMJRV Ausgabe Parameter Restart Variante die durch den Eintrag RV n in der Auftrags Job variablen gesetzt wurde oder Leerzeichen
136. einem harten Abbruch soll ein Netz mit dem Status RUNNING normal weiterlaufen wenn noch Strukturelemente zur Bearbeitung vorhanden sind F r dieses Netz wird intern die Anweisung RESUME NET aufgerufen Sie wird nicht aufgerufen wenn vor der internen Funktion HOLD NET bereits Strukturbeschreibungen mit dem Status HOLD vorhan den sind Wenn die Anweisung NET STATUS nicht angegeben wird wird NET STATUS HOLD angenommen NET USER Der AVAS Administrator kann ber den Parameter NET USER ein stellen ob unter der BS2000 Benutzerkennung der Ablaufsteue rung Jobs zum Ablauf kommen d rfen wenn f r diese in der Netz beschreibung und in der LOGON Anweisung die Angabe USERID fehlt ERROR Wenn die Ablaufsteuerung einen ENTER Aufruf zum Starten eines Jobs ohne Benutzerkennung erkennt erfolgt kein Job Start son dern die Ausgabe der Meldung AVS8513 ins Journal Der Job und somit auch das Netz erhalten den Status ERROR NONE Ein ENTER Aufruf ohne Benutzerkennung wird ausgef hrt Der Job kommt unter der BS2000 Benutzerkennung der Ablaufsteuerung zum Ablauf Wenn die Anweisung NET USER nicht angegeben wird wird NET USER ERROR an genommen SPVS catid Katalogname f r den Shared Pubset auf den AVAS im Mehrrech nerbetrieb die ENTER Dateien anlegen soll Der Name des SPVS ist anzugeben wenn in einem Rechnerver bund Jobs ber einen Shared Pubset ablaufen sollen und SPD nicht beschrieben wird 116 U21462 J Z125 7 Administ
137. eingemischt oder mit dem SDF Kommando MODIFY SDF OPTIONS dem Prozess bekannt gegeben werden siehe dazu das Handbuch SDF Verwaltung 14 U21462 J Z125 7 257 Software Voraussetzungen Dienstprogramm AVAS QUER 258 U21462 J Z125 7 6 Kopplung von AVAS mit MAREN Mit dem Modul MARENAV werden die beiden eigenst ndigen Softwareprodukte AVAS und MAREN ab Version 9 0 miteinander gekoppelt Realisiert wird diese Kopplung indem MARENAV am RZ Exit AVEX7102 der AVAS Komponente Produktionsfreigabe aufgeru fen wird Dieser Modul enth lt unter anderem die MAREN Programmschnittstelle Er nimmt folgende Aktionen vor die im weiteren Verlauf dieses Abschnitts n her erl utert werden e Durchf hren von Datentr gerpr fungen e Eintragen von VSNs in die JCL e Erstellen von Datentr gerlisten N here Informationen zu MAREN finden Sie im Handbuch MAREN Band 1 11 6 1 Durchf hren von Datentr gerpr fungen Alle von einem Netz ben tigten Magnetb nder und Magnetbandkassetten im folgenden Datentr ger oder B nder genannt berpr ft MARENAV auf ihre Verf gbarkeit hin Die VSNSs dieser Datentr ger holt sich MARENAV aus unterschiedlichen Quellen e MAREN Katalog e Systemkatalog TSOSCAT e DVS Kommandos die in den einzelnen Jobs eines Netzes abgesetzt werden Dabei handelt es sich um folgende Kommandos FILE CREATE FILE CREATE FILE GENERATION IMPORT FILE MODIFY FILE ATT
138. einzelnen System Parameter ist daher Folgendes zu beachten ndern der System Parameter der zentralen Zugriffsprozesse AVAS SYSTEM ID Wenn die AVAS SYSTEM ID ge ndert wird werden System Parameter f r ein anderes AVAS System erzeugt Dieses System kann auf die Ablaufdatei und die Journaldatei nicht mehr zugreifen da sie mit einer anderen AVAS SYSTEM ID formatiert wurden CALLIB PERDAT Wenn die Namen der Kalender Bibliothek und der Perioden Datei ge ndert werden kann auf vorhandene Daten nicht mehr zugegriffen werden es sei denn sie werden in die neuen Dateien kopiert Netz und Jobbibliotheken Netze und Jobs k nnen mit COPY ELEMENT in die neuen Bibliotheken kopiert werden Ablaufdatei und Journaldatei Wenn der Name der Ablaufdatei und der Journaldatei ge ndert wird k nnen bereits zur Verarbeitung freigegebene Netze nicht mehr verarbeitet und bearbeitet werden Die beiden Dateien m ssen neu formatiert werden bevor die zentralen Zugriffsprozes se gestartet werden k nnen U21462 J Z125 7 45 Generierung des AVAS Systems Installation und Generierung Andern der System Parameter der Benutzer BKSYS Wenn der Name des Systembenutzerkreises ge ndert wird kann auf die Netze und Jobs des Systembenutzerkreises nicht mehr zugegriffen werden Die in den Netzen verwendeten Jobs bei denen der vorher g ltige Systembenutzerkreis mit angegeben wurde werden nicht mehr gefunden ndern innerhalb eines Benutzerkreises BK
139. erst wenn er die Abschlussmeldung des Server Jobs in der Auftrags Jobvariablen gesichert hat oder wenn die Verbindung zum AVAS Server unterbrochen wird Ein Server Job wird also korrekt pro tokolliert solange die Verbindung zum AVAS Server besteht auch wenn die Ablaufsteue rung inzwischen beendet wurde AVSSTRT richtet eine Datei mit gleichem Inhalt ein wie die ablauf berwachende Auftrags Jobvariable f r AVSSINCM im BS2000 OSD um den Status des Server Jobs zu sichern Damit kann auch nach einem Verbindungsverlust das Ergebnis des Server Jobs noch er mittelt werden Diese Datei wird nachfolgend JV Datei genannt Der Benutzer benennt einen AVAS Server in einer BS2000 Konfigurationsdatei mit dem symbolischen Namen lt server name gt siehe Seite 459 und sch tzt die rechtm ige An gabe dieses Namens durch das Kennwort server pw siehe Seite 459 AVSSINCM pr ft diese Angaben vor dem Start des Jobs und ermittelt aus der Konfigurationsdatei an hand von lt server name gt den Hostnamen des Server Rechners die Portnummer des AVAS Servers und ein Kommunikationskennwort comm pw siehe Seite 460 mit dem sich der Agent AVSSINCM beim Server als AVAS Partner ausweist Dieses Verfahren bietet zwei Vorteile e Die Beschreibung eines Jobs in der Netzstruktur bleibt unabh ngig von Angaben die ein fremdes Betriebssystem Server System zum Start eines Jobs ben tigt e Die Netze und die Jobs sind nicht betroffen wenn sich die
140. f r den Defaultmecha nismus Protokoll der Verarbeitung F r jedes bearbeitete Netz wird AVS8521 CREATE PROD NET netname RESULT ergebnis ausgegeben oder eine Fehlermeldung 328 U21462 J Z125 7 BATCH Anweisungen DELETE DOCUMENT DELETE JOB DELETE DOCUMENT L schen von Dokumentationselementen Mit DELETE DOCUMENT k nnen Dokumentationselemente in der AVAS Benutzerbiblio thek DOCLIB gel scht werden DELETE DOCUMENT ELEMENT NAME bk_Jelement Der Parameter ELEMENT NAME muss angegeben werden der Parameterwert kann teil qualifiziert angegeben werden Protokoll der Verarbeitung F r jedes gel schte Dokument wird AVS8521 DELETE DOCUMENT elementname RESULT ergebnis ausgegeben oder eine Fehlermeldung DELETE JOB L schen von BS2000 Jobs S Prozeduren Server Jobs und JCL Bausteinen Mit DELETE JOB k nnen BS2000 Jobs S Prozeduren Server Jobs und JCL Bausteine in der AVAS Benutzerbibliothek JCLLIB gel scht werden DELETE JOB ELEMENT NAME bk_ element Der Parameter ELEMENT NAME muss angegeben werden der Parameterwert kann teil qualifiziert angegeben werden Protokoll der Verarbeitung F r jeden gel schten BS2000 Job Server Job oder jede gel schte S Prozedur wird AVS8521 DELETE JOB elementname RESULT ergebnis ausgegeben oder eine Fehlermeldung U21462 J Z125 7 329 DELETE JOB LOG DELETE NET DESCRIPTION BATCH Anweisungen DELETE JOB LOG L schen Protokolle eines Netzes Mit
141. folgenden Umgebungsvariablen k nnen zur Steuerung von avasr3 eingesetzt werden AVASRSPATH Verzeichnis in dem die Datei sapuser ini gesucht wird Default aktuelles Arbeitsverzeichnis AVASRSLOGFILE Name der LOG Datei zur Aufnahme von Job Protokoll und Exceptions Default ard datum zeit log Beispiel ar 000206 140555 log AVASRS3TRACE Y in erster Stelle Trace Datei wird geschrieben sonst keine Trace Datei Name der Trace Datei ar3 datum zeit trc Mit der Umgebungsvariablen RFC_INI kann au erdem gesteuert werden wo die RFC Schnittstelle von mySAP com die Datei saprfc ini sucht Dabei muss die Umgebungs variable RFC INI den vollst ndigen Pfad der Datei saprfc ini enthalten Wenn die Variable nicht gesetzt ist wird die Datei im aktuellen Arbeitsverzeichnis gesucht 11 5 5 4 Programmablauf Im mySAP com wird ein Job angelegt der alle Job Steps enth lt die ber Eingabe Para meter von avasr3 angegeben wurden Anschlie end wird der Job mit der Startzeit sofort an den mySAP com Job Scheduler bergeben Alle Jobs die durch avasr3 im mySAP com System gestartet werden laufen dort in Jobklasse C Der Job Status wird in einer Schleife gelesen bis der Job beendet oder abgebrochen wird Anschlie end wird das Job Protokoll gelesen und in die LOG Datei geschrieben Alle Fehler die im Programmablauf von avasr3 vor der bergabe des Jobs an den mySAP com Job Scheduler auftreten f hren zum Programm Exit Code
142. gesammelt und in einer zentralen Bibliothek gespeichert werden F r die bermittlung von Job Ablaufprotokollen dienen im BS2000 OSD zwei Programme die in den Job zu integrieren sind e Das Programm SIGNAL signalisiert AVAS dass ein Protokoll zu bernehmen ist e Das Programm TRANSFER bertr gt das Protokoll vom Benutzerbereich in den AVAS Bereich e Zum Erfassen von LOG Dateien von Server Jobs m ssen die Programme SIGNAL und TRANSFER in der Startprozedur von avssincm aufgerufen werden e In den Server Jobs muss zum Bekanntgeben der LOG Dateien das Programm avslog verwendet werden siehe Abschnitt AVSLOG Zuordnung der Protokolldateinamen auf Seite 493 Das AVAS System ist um die DCAM Anwendung CENTRAL erweitert die das Protokoll bernimmt und in der Protokollbibliothek AVAS Pool speichert F r die nachtr gliche Speicherung von signalisierten Protokollen steht die Dialoganwei sung ADD JOB LOG zur Verf gung F r jeden Jobablauf k nnen maximal 99 Protokolle signalisiert und gespeichert werden Die Protokolle k nnen ber die Anweisungen SHOW JOB LOG SHOW NET STATUS und SHOW JOURNAL angezeigt werden Im Rahmen der Reorganisation k nnen die Protokolle gesichert und gel scht werden Einzelne Protokolle k nnen auch ber die Dialoganweisung DELETE JOB LOG gel scht werden Damit Protokolldateien gesichert und gel scht werden k nnen m ssen sie den Status ADDED oder TRANSFERRED haben Sammeln der Protoko
143. geschrieben z B wenn einem Kalendertag kein Symdat zugeordnet ist e Wenn als Dokumentname f r die Netzbeschreibung STD angegeben wird werden in der Tabelle netdoktab folgende Namen eingetragen bkdok benutzerkreis des netzes dokname netzname e Wenn als Dokumentname f r die Orderbeschreibung STD angegeben wird werden in der Tabelle orderdoktab folgende Namen eingetragen bkdok benutzerkreis des netzes dokname netzname ordername 238 U21462 J Z125 7 Dienstprogramm AVAS QUER Arbeiten mit AVAS QUER e n den Ausgabedateien sind immer alle Attribute einer Datenbanktabelle angegeben Attribute f r die keine Werte in den AVAS Daten vorhanden sind werden mit Leerzei chen versorgt z B in der Tabelle ordertab das Attribut enterfile bei einer Condition Die so erzeugten Ausgabedatei en muss der Benutzer auf sein Zielsystem bertragen und dort zum Ablauf bringen oder die Daten in die Datenbank importieren Die Daten dieser Ausgabedatei en versorgen die einzelnen Felder der Datenbank Tabellen Es wird empfohlen die Ausgabedatei en so zu benennen dass sie auf sql enden Der Benutzer entscheidet durch die AVAS QUER Anweisung CREATE FORMAT in wel chem Format die Daten in die Ausgabedatei geschrieben werden Folgende Formate stehen zur Verf gung e INSERT FORMAT Erzeugen einer Ausgabedatei mit SQL Anweisungen in der Form INSERT INTO tabellenname attributnamel VALUES
144. in einer zentralen Bibliothek 3 3 2 Verwalten der Benutzer F r die Verwaltung der Benutzer eines AVAS Systems stehen dem AVAS Administrator folgende Anweisungen zur Verf gung CANCEL USER Zwangsabmelden von Benutzern MODIFY SYSTEM PARAMS ndern der System Parameter SEND MESSAGE Senden einer Nachricht an Benutzer SHOW SYSTEM PARAMS Anzeigen der System Parameter SHOW USER Anzeigen der angemeldeten Benutzer START EXIT Aktivieren des RZ Exit AVEX2001 Eingaben zum Verwalten der Benutzer ber die kontrollierenden Jobvariablen der Zugriffs prozesse sind im Abschnitt Bedienen der Zugriffsprozesse auf Seite 127 beschrieben 3 3 3 Verwalten der System Parameterdatei Die Parameter der System Parameterdatei siehe Abschnitt Generierung des AVAS Sys tems auf Seite 18 kann der AVAS Administrator durch die nachfolgend beschriebenen Anweisungen anzeigen und ndern Es ist nicht in jedem Fall eine nderung der angezeig ten Definitionen m glich Die Verbindungen und Zusammenh nge der einzelnen Parameter innerhalb eines Parametersatzes sowie zwischen den einzelnen Parameters tzen sind den oben genannten Seiten zu entnehmen wenn sie nicht aus den Anzeigen dieser Anweisun gen zu erkennen sind U21462 J Z125 7 135 Administrationsaufgaben im Betrieb Administration von AVAS 3 3 4 Verwalten der Ablaufprotokolle Die Ablaufprotokolle von BS2000 Server Jobs die ber die AVAS Ablaufsteuerung gestar tet werden k nnen ber AVAS
145. j9 Zeit hhmmss 6 j2 Protokoll Status Code 1 2t Protokoll Status Text 11 j3 TRANSFER Parameter Code 1 3t TRANSFER Parameter Text 5 j4 Protokoll l schen Code 1 4t Protokoll l schen Text 3 Elementaufbau Typ D e Funktionssatz Ein Funktionssatz beschreibt die Informationen der Funktionsdurchf hrung Er ist nur vorhanden wenn ein Protokoll durch eine Funktion z B ADD JOB LOG eingebracht wurde Aufbau funktion lt f1 gt lt f2 gt lt f3 gt lt f4 gt Bedeutung und L nge der Namensteile in Klammern funktion Satzidentifikation 24 z B ADD JOB LOG 11 Name des Avas Benutzers 8 f2 Datum jjjjmmtt 8 f3 Zeit hhmmss 6 14 Name der Datei die zugewiesen wurde 54 U21462 J Z125 7 139 Administrationsaufgaben im Betrieb Administration von AVAS e Protokoll Datens tze Die Protokoll Datens tze sind die eingelesenen S tze der bertragenen Datei Status der Elemente Im DIRECTORY Bereich des Elements vom Typ S und in den Protokollmeldung S tzen wird ein sedezimaler interner AVAS Status gef hrt Dieser Status der Protokolleintr ge gibt folgende Auskunft ADDED Die Protokolldaten des Jobs wurden ber die Funktion ADD JOB LOG gesammelt ASSIGNED Keine Protokolldaten f r den Job vorhanden Im Job wurde ein Protokollname signali siert und keine Ubertragung der Daten gefordert CREATED Keine Protokolldaten f r den Job vorhanden Der Protokolleintrag wurde durch die Ablaufsteuerung an
146. jvname Name einer Jobvariablen die eine maximal 8 Zeichen lange Zeichenkette zur Verschl sselung der Kennw rter enth lt Wenn die Jobvariable mit einem Lesekennwort READ PASSWORD gesch tzt ist muss in der Prozedur vorher das BS2000 Kommando ADD PASSWORD abgesetzt werden Hinweis Der AVAS Administrator muss sicherstellen dass der zentrale Zugriffsprozess ZDL und die Ablaufsteuerungen immer mit dem gleichen ENCRYPTION CODE gestartet werden Die Netze k n nen sonst nicht verarbeitet werden MAX SERIAL LOCK Die Anweisung beschreibt die maximale Bearbeitungszeit f r die Funktionsausf hrung einer serialisierten AVAS Anweisung Der Wert in Sekunden ermittelt sich aus der maximalen Bearbei tungszeit f r das gr te Netz Die Genauigkeit f r die Bearbeitung betr gt 60 Sekunden STD Die intern festgelegte maximale Bearbeitungszeit betr gt 180 Sekunden nnnnn Zeitangabe in Sekunden Eine maximale Bearbeitungszeit zwischen 60 und 21 599 Sekunden kann vorgegeben werden U21462 J Z125 7 109 Starten und Beenden der AVAS Prozesse Administration von AVAS MAX SERIAL WAIT Die Anweisung beschreibt die Wartezeit einer Funktion mit Seriali sierungsverarbeitung Die Genauigkeit f r die Bearbeitung betr gt 60 Sekunden STD Die intern festgelegte Wartezeit von 300 Sekunden wird verwendet nnnnn Zeitangabe in Sekunden Eine Wartezeit zwischen 60 und 21 599 Sekunden ist m glich Hinweise Die Anweisungen CREATE
147. nicht ben tigt ww Anweisung ist wahlweise anzugeben wenn sie nicht angegeben ist wird ein Standardwert genommen 1 Anweisung muss angegeben werden wenn JOBLOG SAVE OPTION YES angegeben ist U21462 J Z125 7 169 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation 2 Anweisung muss angegeben werden wenn NET NAME bk netname bk group ange geben ist Anweisung muss angegeben werden wenn NET NAME ALL bk angegeben ist 3 Anweisung muss nur dann angegeben werden wenn mit der PLAM ZD bzw der UPAM ZD mit REO PASSWORD ein besonderes Kennwort f r die Reorganisation vereinbart wurde E Die Reorganisationsanweisungen in alphabetischer Reihenfolge AVAS SYSTEM ID Mit der Reorganisationsanweisung AVAS SYSTEM ID wird das AVAS System ausgew hlt das reorganisiert werden soll Die Anweisung muss bei jeder Funktion gegeben werden AVAS SYSTEM ID string string 7 Zeichen langer Name des AVAS Systems das reorganisiert werden soll ber die Anweisung werden die zentralen Zugriffsprozesse und damit die Dateien ausgew hlt AVAS USER ID Mit dieser Reorganisationsanweisung wird der Name eines Benutzers angegeben wenn ein einzelnes Netz NETNAME bk netname oder eine Netzgruppe NET NAME bk group reorganisiert werden soll Der Benutzer muss dem Benutzer kreis bk des Netzes bzw der Netzgruppe zugeordnet sein Es gen gt nicht einen Benut zer mit Berechtigung anzugeben Der Benutzer muss
148. nnn nnn nnn pp pp ORT NAME OUT OF PLAN KTION S SYSTEM ID S USER ID NAME OD NAME PUT WORK FILE FIELDS ORDER STATE ORDER ECT STATUS ESHOLD PUT REPORT FILE 1462 J Z125 7 307 AVA GLO NET AVA NET REP FUN AVA AVA NE PE OU 50 50 SEL TH OU U2 AVAS Reports OUT OF PLAN Report Liste L06002 PLANNED NET MODIFIC ATION Report DATE ttmmjj TIME hh mm PAGE nnnn MOD TIME OBJECT USER DATE ttmmjj TIME hh mm PAGE nnnn U21462 J Z125 7 AVAS Vnn yxmm L06002 REPORT Generator LIST PLANNED NET MODIFICATION NET NAME STATE MOD TYPE AVAS Vnn yxmm L06002 REPORT Generator LIST PLANNED NET MODIFICATION REPORT NAME PLANNED NET MODIFICATION FUNKTION AVAS SYSTEM ID AVAS USER ID NET NAME PERIOD NAME OUTPUT WORK FILE SORT FIELDS ORDER OUTPUT REPORT FILE 308 AVAS Reports Prozeduren und Bibliotheken f r die AVAS Reports 7 5 Prozeduren und Bibliotheken f r die AVAS Reports Prozeduren F r den Ablauf des REPORT Generators ist die Bibliothek SYSPRC AVAS 070 mit dem J Element AVS REPORT vorhanden die als Beispielproze dur f r den Einsatz individuell ge ndert werden muss Es wird angeraten die Anweisungen f r die Reports in einer SAM Datei abzulegen und diese ber SYSDTA zuzuweisen Bibliotheken F r den Ablauf des REPORT Generators werden die Biblio
149. oder S Prozeduren die mittels einer AVAS Anweisung im Rahmen der Parametermodifikation wieder in den Job oder in die S Prozedur eingesetzt wird JCLLIB Linkname f r die Bibliothek der Jobs S Prozeduren Server Jobs und JCL Bau steine 530 U21462 J Z125 7 Fachw rter JCLSYS Linkname f r die zentrale Bibliothek der Jobs S Prozeduren Server Jobs und JCL Bausteine JMDLIB Linkname f r die Bibliothek der modifizierten Jobs S Prozeduren und Server Jobs JMDSYS Linkname f r die zentrale Bibliothek der modifizierten Jobs S Prozeduren und Server Jobs Job BS2000 Job S Prozedur oder Server Job JOB BS2000 Kommandofolge beginnend mit LOGON und endend mit LOGOFF zus tzlich k nnen in die Kommandofolge spezielle AVAS Anweisungen einge arbeitet sein JOB ACCOUNT Parameter f r ENTER Aufruf des BS2000 Jobs der S Prozedur oder des Server Stellvertreters JOB CAT Katalogkennung eines SLAVE Rechners oder Servername eines entfernten Rechners JOB CLASS Parameter f r ENTER Aufruf des BS2000 Jobs der S Prozedur oder des Server Stellvertreters JOB DOC Name des Dokumentationselements zu einem Job einer S Prozedur oder einem Server Job JOB INDEX Indexstufe eines Jobs einer S Prozedur oder eines Server Jobs im Netz JOB LOG Unter AVAS gespeicherte Job Ablaufprotokolle U21462 J Z125 7 531 Fachworter JOBMAP Linkname f r die Bibliothek der Benutzermasken bzgl einzelner Jobs oder S Prozedure
150. pfixJNAM pfixFNAM pfixFMSG pfixDFIX R ckgabe der RZ Routine an AVAS Anschlie end an den Basisdatenteil werden die Werte Daten der Maskenfelder in folgen der Form im Kommunikationsbereich bergeben maximale L nge 1930 Byte 2 Byte 2 Byte 8 Byte 2 Byte maximale L nge 192 Byte 2 Byte n Byte maximale L nge 192 Byte U21462 J Z125 7 Satzl ngenfeld Reserve REM Param Name Feldl nge Maske Datenl nge Daten 94 Installation und Generierung RZ Exits im AVAS System Das Ende der Daten wird durch den Wert Null X 0000 im Satzl ngenfeld erkannt Dies gilt auch f r die R ckgabe der Daten durch die RZ Routine Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden pfixOK EQU X 00 Die Felddaten werden bernommen und die Jobmaske wird ausgegeben pfixUPD EQUX O2 Die Felddaten werden bernommen aber die Jobmaske wird nicht mehr ausgegeben Modifikation erfolgt mit den bergebenen Daten pfixiGN EQU xX 06 Abbruch der Modifikation f r diese Jobmaske Verhalten wie bei CMD IGNORE im Dialog pfixABE EQUX 08 Abbruch der Modifikation Verhalten wie bei CMD RETURN im Dialog Hinweise e Die RZ Routine bernimmt alle AVAS Variablen mit ihren Wertzuweisungen au er S nnn e Wenn die RZ Routine andere Returncodes zur ckmeldet setzt AVAS im Feld MSG eine Meldung ab die Modifikation wird nicht durc
151. positives Intervall beschreiben Der Zugriff auf die Periode f hrt sonst zur Meldung AVS5188 mit Abbruch der aktuellen Anweisung Beispiel PERIOD NAME ERR MONAT ERLEDIGT PERIOD START DATE 02 0 PERIOD END DATE 0 0 Diese Periode f hrt jeweils am ersten Tag eines Monats zur Meldung AVS5188 kann aber an allen anderen Tagen genutzt werden U21462 J Z125 7 322 CREATE PERIOD PERIOD NAME ERR WOCHE ERLEDIGT PERIOD START DATE 1 0 PERIOD END DATE 1 0 Diese Periode f hrt jeden Montag zur Meldung AVS5188 da START DATE Montag 00 00 Uhr ist und END DATE Sonntag 23 59 Uhr BATCH Anweisungen e Beim Parameter PERIOD NAME sind keine Ersatzzeichen zugelassen e Zur Ermittlung der realen Daten einer variablen Periode wird auf den Kalender nicht zugegriffen Dies ist besonders zu beachten wenn ULTIMO auf einen Feiertag f llt nicht Sonntag oder Samstag oder der Freitag vor ULTIMO ein Feiertag ist bei Ver wendung START END DATE 0 Die realen Daten einer variablen Periode werden beim Start einer AVAS Anweisung ermittelt und nur bei der nderung eines Parameters neu beschafft 323 Ab AVAS 4 04 wird die Prozedur AVS GENPERIOD Element der Bibliothek SYSPRC AVAS 070 ausgeliefert mit der folgende Standard Perioden mit variablen Rand daten in der PERDAT erzeugt werden E PERIOD END DATE TIM Q 0 23 2 0 23 SEI v23 0 0 23 1 0 23 2 0 23 3 4
152. r jedes Element eine Meldung mit RESULT ausgegeben Damit ergibt sich im Fehlerfall folgende beispielhafte Meldungsfolge AVS8301 EINGABE CREATE PLAN NET AVS8301 EINGABE NET NAME net AVS8301 EINGABE PERIOD NAME period AVS5912 ANZAHL DER AUSGEWAEHLTEN ELEMENTE nnn AVS8521 CREATE PLAN NET element 1 RESULT CREATED AVSmmmm Fehlermeldung zum element 2 AVS8521 CREATE PLAN NET element 2 RESULT ERROR 344 U21462 J Z125 7 BATCH Funktionen Fehlerinformation bei den BATCH Funktionen Der Auftragsschalter 30 Warnung oder 31 Fehler wird dabei abh ngig vom Meldungs gewicht WEIGHT CODE der Meldung AV8Bmmmm gesetzt Wenn mehrere Meldungen ausgegeben werden k nnen auch beide Schalter gesetzt sein Hinweise Die Auftragsschalter werden abh ngig vom Parameter WEIGHT CODE der AVAS Meldungsdatei gesetzt Folgende Regel gilt WEIGHT CODE 0 bis 91 bliche Information kein Auftragsschalter WEIGHT CODE 92 und 93 Meldung als Warnung Auftragsschalter 30 WEIGHT CODE 94 bis 99 Meldung eines Fehlers Auftragsschalter 31 Der Benutzer kann das Setzen der Auftragsschalter nicht beeinflussen Der Benutzer muss den Auftragsschalter nach Durchf hrung der BATCH Funktion l schen wenn er danach nicht mehr gesetzt sein darf Meldungen AVAS V7 0A mit WEIGHT CODE Die Meldungsnummern der AVAS Version 7 0A mit ihrem zugeordneten WEIGHT CODE wie er bei der Auslieferung festgelegt ist sind im AVAS Tabellenheft
153. schen von Dokumentationselementen DELETE JOB L schen von BS2000 Jobs S Prozeduren Server Jobs und JCL Bausteinen DELETE JOB LOG L schen Protokolle eines Netzes DELETE NET DESCRIPTION L schen von Netzen DELETE PERIOD L schen einer Periode DELETE PLAN NET L schen geplanter Netze im Produktionsplan DELETE PROD JOB L schen statischer BS2000 Jobs S Prozeduren und Server Jobs END Beenden der Folge der BATCH Anweisungen HOLD NET Anhalten von im Ablauf befindlichen Netzen MODIFY COND DESCRIPTION Andern eines Bedingungseintrags REPEAT NET Mehrfache Freigabe eines geplanten Netzes RESTART NET Wiederanlauf eines Netzes nach Fehler RESUME NET Aufl sen des HOLD Zustandes SIGNON Beginn der Folge der BATCH Anweisungen SUBMIT NET Freigabe geplanter Netze Prozeduren und Bibliotheken f r die BATCH Funktionen Fehlerinformation bei den BATCH Funktionen Externe Erstellung von AVAS Elementen Externe programmtechnische Erstellung von Netzen Externe Erstellung von Auftr gen Externe Erstellung von Dokumenten 7 3 7 4 7 5 8 1 8 2 8 3 9 1 9 3 U21462 J Z125 7 Inhalt 10 Programmschnittstelle von AVAS 373 10 1 Anweisungen der AVAS Programmschnittstelle
154. ssen innerhalb der Konfigurationsdatei eindeutig sein Sie gelten als identifizierende Schl ssel f r die weiteren Angaben Die Konfigurationsdatei muss von AVSSINCM aus lesbar sein U21462 J Z125 7 520 AVAS SV Plattform bergreifende Jobsteuerung Einsatzvorbereitung Der AVAS Server AVSRECV wartet unter der Portnummer die f r einen Server Partner angegeben wurde auf Auftr ge von AVSSINCM F r jeden Server der auf einem Rech ner gestartet werden soll ist eine eigene Portnummer notwendig Wenn AVSRECV unter root Superuser gestartet wird ist f r alle Benutzer User dieses Rechners nur ein AVSREOCV n tig und damit nur eine Portnummer Der AVAS Server AVSRECV kennt nur ein Kommunikationskennwort Dies bedeutet dass f r alle Server Namen die den gleichen Host und die gleiche Portnummer adres sieren das gleiche Kommunikationskennwort gelten muss 4 Anpassen der Startprozedur f r AVSSINCM Die ausgelieferte Startprozedur f r AVSSINCM siehe Beispiel auf Seite 463 muss den Bed rfnissen der Konfiguration angepasst werden wenn die Server Informationen nicht durch den Eintrag Server Name in der Netzbeschreibung definiert sind Die Parameter der Startprozedur entsprechen den Eintr gen in der Konfigurationsdatei server name server pw host portnr user comm pw dir pfad A A A AVS DEF SERVER NAME AVS DEF SERVER PASSW AVS DEF HOST NAME AVS DEF PORT d AVS DEF USER I DE DE DE AVS DE Bop AVS DEF DIRE
155. uft zun chst auch AVSSTHT privilegiert In diesem Fall wechselt AVSSTRT in die ber gebene Benutzerkennung und arbeitet fortan mit den Rechten die diese Kennung hat Wenn AVSRECYV nicht privilegiert gestartet wurde kann AVSSTRT seine Benutzer kennung nicht wechseln Er kann daher nur Server Jobs starten die in der gleichen Kennung wie AVSRECV ablaufen sollen Wenn ihm eine andere Kennung bergeben wird ist die Aufgabe nicht zu erf llen und AVSSTRT beendet sich mit Fehler e Wenn ein Server Job gestartet werden soll richtet AVSSTRT die Verzeichnisse f r die Bearbeitung des Jobs sowie die Dateien f r das Job Skript und die Auftrags Jobvariab le ein Sollten die Dateien bereits vorhanden sein werden sie berschrieben e Wenn ein externer Job Strukturelement mit FUNCTIONZX TYPE EXT ein im Server System bereitgestellter Job ablaufen soll wird dessen Skript in die neu eingerichtete Datei kopiert Soll ein in AVAS verwalteter Server Job Strukturelement mit FUNCTION X TYPE STD MOD laufen wird dessen Skript von AVSSINCM ber nommen und in die Datei eingetragen e Der so vorbereitete Job wird gestartet und sein Ende abgewartet Wenn sich der Server Job mit Exit Code 0 beendet hat nimmt AVSSTRT an dass er ordnungsgem abgelaufen ist und setzt den SV Status und den Zusatzstatus auf TT Jeder andere Exit Code f hrt zum Status AA und sp ter in AVAS zum Status ERROR des Server Jobs Der Exit Code wird 4 stell
156. und AVSERLTC definieren 431 AVSCOBBW Arbeitsbereich definieren 222222 iliis 432 AVSCOBCD Verzeichniseintrag Bedingungseintr ge in Ablaufdatei definieren 3 AVSCOBCE Bedingungseintrag in der Ablaufdatei definieren 434 AVSCOBAJD Netzverzeichnisbeschreibung Journaldatei definieren 435 AVSCOBJN Journalsatzkopf definieren 436 AVSCOBRT Ergebnisbereich definieren i 437 11 Plattform bergreifende Jobsteuerung mit AVAS SV 439 11 1 installation von NASEN au iude dex aao EE 445 11 121 Installation auf UNIX Plattformen 2222 RII II 445 11 1 1 1 Installation von AVAS SV und von AVAS R3JobControl auf Solaris SPARC 445 TT 4 1 2 Installation von AVAS SV auf IBM AIX HP UX UnixWare Tru64 UNIX und LINUX 446 11 1 2 Installation von AVAS SV und von AVAS R3JobControl auf Windows Systemen 448 11 1 3 Installation von AVAS SV BS2 auf einem BS2000 System 449 U21462 J Z125 7 Inhalt Deinstallation von AVAS SV i Deinstallation auf UNIX Platttormen esee Deinstallation von AVAS SV und von AVAS R3JobControl unter Solaris SPARC Deinstallation von AVAS SV unter IBM AIX HP UX UnixWare Tru64 UNIX Deinstallation von AVAS SV auf Windows Systemen Deinstallation von AVAS SV BS2 auf einem BS2000 System Ablaufsteuerung und kontrolle von
157. von CD ROM Der Installationspfad kann dabei angegeben werden Konfigurieren von FHS DOORS Nachdem die Masken auf dem PC installiert wurden ist es notwendig FHS DOORS mit zuteilen in welchem Directory die AVAS DOORS Masken gesucht werden sollen Dazu k nnen Sie entweder eine neue FHS DOORS Sitzung definieren oder eine bereits beste hende ndern e Aufruf von FHS DOORS durch Anklicken der FHS DOORS Ikone im Windows Syste me e ffnen einer Sitzung CTRL N bzw anklicken von Sitzung und ffnen oder Neuanlegen einer Sitzung CTRL O bzw anklicken von Sitzung und Neu e Einstieg in die Konfigurations Masken der Sitzung Nach dem Anlegen einer neuen Sitzung befinden Sie sich sofort in der Sitzungs Konfigura tionsmaske Wenn Sie eine bestehende Sitzung ge ffnet haben erreichen Sie diese durch Anklicken von Konfiguration und Sitzung e Eintragen des Ressourcen Pfades durch Anklicken des entsprechenden Teils des Fensters Wenn unterhalb von Ressourcenpfad das f r AVAS DOORS neu angelegte Verzeichnis erscheint z B C NProgrammeNSiemensNVAVAS NTNAVASDOORS ist der Parameter richtig versorgt e Dierestlichen Parameter m ssen gem der auf dem PC bestehenden Soft und Hard ware und dem Handbuch FHS DOORS 8 versorgt werden AVAS QUER Folgender Punkt ist zu ber cksichtigen e Das Programm wird entweder mit der Prozedur AVS QUER aus SYSPRC AVAS 070 oder als Progr
158. wird im Benutzerprogramm durchgef hrt LA l parameterleiste LA 13 lt savearea gt L 15 2V CAVASBASS BALR 14 15 Die Register 13 bis 15 und der Registersicherstellungsbereich nutzt AVAS f r die Kontrolle einer ordnungsgem en Beendigung der Programme Wenn das Benutzer programm hier eine eigene Kontrolle bernimmt sind Fehler in Verbindung mit den zentralen Zugriffsroutinen von AVAS ZDs nicht ausgeschlossen 2 Programm bersetzen F r die bersetzung eines Assembler Programms mit AVAS Parameterstrukturen ist die Zuweisung der Makrobibliothek erforderlich Die Zuweisung kann mit folgendem BS2000 Kommando erfolgen ADD FILE LINK LINK NAME ALTLIB FILE NAME SYSLIB AVAS 070 3 Programm binden Der AVAS Schnittstellenmodul AVSBCALL ist aus der Bibliothek SYSLNK AVAS 070 fest zum Hauptprogramm hinzuzubinden 4 Programm starten Bei dem ersten Aufruf aus dem Benutzerprogramm an AVAS l dt das AVAS Schnittstel lenmodul weitere Module nach Der Ladeaufruf erfolgt unter Angabe des Bibliothek namens SYSLNK AVAS 070 386 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Schnittstelle Wenn die AVAS Module nicht in der Bibliothek mit dem Namen zur Verf gung stehen oder wenn die AVAS Bibliothek in einem anderen Pubset abgelegt ist muss vor dem Programmstart eine Zuweisung mit folgendem BS2000 Kommando erfolgen SET FILE LINK LINK NAME SYSLNK FILE NAME lt catid gt lt userid gt SYSLNK AVAS 070
159. zum Zeitpunkt der Erstellung des Reports MOD TYPE Die Art der Ver nderung und die AVAS Funktion mit der die nderung durchgef hrt wurde AVAS Funktionen MODIFY PLAN NET f r ge nderte Netzparameter EDIT PROD JOB f r einen ge nderten Auftrag SUBMIT NET f r ge nderte Netzparameter MODIFY SUBMIT NET f r ge nderte Netzparameter MODIFY SUBMIT JOB f r einen ge nderten Auftrag AVAS Aktionen CHANGED f r ge nderte Parameter oder JCL Anweisungen INSERTED f r eingef gte JCL Anweisungen DELETED f r einen gel schten Auftrag oder eine JCL Anweisung SHIFTED f r ein verlagertes Netz 302 U21462 J Z125 7 PLANNED NET MODIFICATION Report 303 Zeitpunkt der nderung in der Form ttmmjj hh mm Der Name des ge nderten Objektes Dies sind NET NAME JOB NAME oder CONDITION NAME Name des AVAS Benutzers der die nderung durchgef hrt hat AVAS Reports MOD TIME OBJECT USER U21462 J Z125 7 OUT OF PLAN Report AVAS Reports 7 4 OUT OF PLAN Report Beim OUT OF PLAN Report werden folgende REPORT Anweisungen verarbeitet REPORT NAME OUT OF PLAN FUNKTION ALL CREATE SORT PRINT AVAS SYSTEM ID string SYSTEM PASSWORD STD kennwort AVAS USER ID avuser USER PASSWORD kennwort NET NAME OWN ALL x bk_ bk_netname PERIOD NAME peri od OUTPU ORK FILE full filename OUTPU ORK LINK full filename SORT STATE OR
160. zweites Datum angegeben ist werden alle Protokolle gel scht die vom ersten bis zum zweiten Datum einschlie lich entstanden sind 176 U21462 J Z125 7 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien JOBLOG DELETE STATUS Die Reorganisationsanweisung legt die Status der Protokolle fest die bei der Reorganisa tion der LOGSYS Bibliothek gel scht werden sollen Die Anweisung darf nur zusammen mit den Reorganisationsanweisungen FUNKTION JOBLOG und DELETE JOB LOG YES angegeben werden JOBLOG DELETE STATUS STD ALL status status status Protokolleintr ge mit dem Status SAVED werden gel scht Alle Protokolleintr ge eines Netzes werden gel scht nur zusammen mit NET NAME BK name Alle Protokolleintr ge mit dem angegebenen Status werden gel scht STD ALL status status status Alle Protokolleintr ge mit einem der in Klammern angegebenen Status werden gel scht JOBLOG SAVE OPTION Die Reorganisationsanweisung legt fest ob Protokolldaten gesichert werden JOBLOG SAVE OPTION STD YES NO Die Protokolldaten der Netze die in der Ablaufdatei den Status ENDED oder ABENDED erreicht haben werden gesichert Die Sicherung erfolgt im Zusammenhang mit der Reorganisation der Ablaufdatei Die Wertzuweisung STD wird verarbeitet wenn die Funktionen ABLDAT und JOBLOG angegeben werden Netze deren signalisierte Protokolldateien den Status ASSIGNED oder ERROR besitzen
161. 0 293 f l 23 0 0 00 7 0 234 EE 35 Eel 23 TEsl 23 0 0 00 0 23 Tt 23 RSEN 323 0 0 00 12 23 ART TIME CO COOC COOC CO CH CA C 5 O0 115 12 Lex EI ELITE QI CO x CO COOC CO CH CE CL EX C DI IS CO COOC CH QUI CO GO gt GO CES E CX CO C ce LA CEU ap E tC XI Co D DEI TI PERIOD SI DATE 0 SE skO SFO 0 0 0 1 1 40 1 40 0 FEIN 0 wr 0 1 01 0 3 2 1 0 1 2 3 0 tt 4 O kO OO CH CH 0 D NAME ERIO ES See LI FIT JIL TU EDI C e ZE rm rn rm rm t2 CC gt gt gt gt gt p U21462 J Z125 7 CREATE PERIOD BATCH Anweisungen Wenn bereits eine Periode mit einem der Standardnamen in der Periodendatei vorhanden ist wird mit diesem Namen keine Standardperiode eingetragen In diesem Fall meldet die Prozedur AVS GENPERIOD AVAS ABLAUF mit Warning CREATE PERIOD PERIOD NAME period PERIOD START DATE tt mm jj PERIOD START TIME hh mm PERIOD END DATE tt mm jj PERIOD END TIME hh mm Der Parameter PERIOD NAME muss vollqualifiziert angegeben werden Wenn der Parameter PERIOD START TIME nicht angegeben wird wird PERIOD START TIME 00 00 angenommen Wenn der Parameter PERIOD END DATE nicht angegeben wird wird PERIOD END DATE PERIOD START DATE angenommen
162. 095726 06 095726 06 095726 06 095726 sr sap B40 DVE tderr3 06 095726 AVASR3 Job lo Date 20040906 095725 00 200409 200409 200409 200409 0409 2 CQ c P o P P P P 20 P P o P o MD 0409 tdout 0409 0409 PFPA 0409 0409 0409 0409 DEI CC CO Y c c 0409 U21462 J Z125 7 Verhalten im Fehlerfall AVAS SV Plattform bergreifende Jobsteuerung 11 6 Verhalten im Fehlerfall W hrend der Produktion kann es zu Problemen bzw Ausf llen kommen Um einen gesi cherten Betrieb zu gew hrleisten setzt AVAS bei einem Neustart e von AVAS selbst e des Betriebssystems oder e einzelner Systemkomponenten am Ausfallzeitpunkt wieder auf Von bereits gestarteten und w hrend der Ausfallzeit been deten Jobs BS2000 Remote Jobs Server oder mySAP com Jobs wird das Ergebnis er mittelt Bei Jobs die noch nicht beendet sind wird auf das Ergebnis gewartet Generell f hrt AVAS beim Wiederanlauf folgende Ma nahmen durch e AVAS ermittelt den aktuellen Status der ber AVAS gestarteten BS2000 Server und mySAP com Jobs Die Information welche Jobs zum Ausfallzeitpunkt im Status RUN NING waren bezieht AVAS aus der eigenen Ablaufdatei Die Information ber den Job status bezieht AVAS aus der dem Job zugeordneten Monitor Jobvariablen oder durch Anfrage QUERY Modus an den AVAS Server e Inder Zwischenzeit beendete Jobs erhalten den Zustand ENDED oder ERROR noch laufende Jobs b
163. 1 CLIENT 010 NAME JOBUS1 PASSWORD xyZz LANGUAGE D Der Parameter USER ist der Schl ssel f r alle weiteren Eintr ge in der Datei bis zum n chsten USER CLIENT bezeichnet den mySAP com Mandanten NAME den mySAP com Benutzer unter dem sich avasr3 bei mySAP com anmeldet Die Anmeldespra che ist bis mySAP com Release 3 1 1 stellig ab 4 0 2 stellig Man kann sich aber auch noch bei mySAP com 4 0 mit einem Gro buchstaben anmelden ACHTUNG Zum Erzeugen der Datei sapuser ini wird das Programm edusini mitgeliefert damit das Benutzerkennwort f r mySAP com verschl sselt abgelegt werden kann Die Datei darf nicht mit einem Editor ge ndert werden Mit der Umgebungsvariablen ASVASRSPATH kann das Verzeichnis definiert werden in dem die Datei sapuser ini von den Programmen edusini und avasr3 gesucht wird Standard verzeichnis ist das aktuelle Arbeitsverzeichnis U21462 J Z125 7 497 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung Pflege des mySAP com Berechtigungsobjektes S XMI PROD Vor der ersten Anmeldung von avasr3 am mySAP com System muss dieses externe Job Management Tool dem mySAP com System bekannt gegeben werden Dies geschieht mit Hilfe des mySAP com Berechtigungsobjektes S XMI PROD das f r den Benutzer unter dem sich avasr3 bei mySAP com anmeldet folgenderma en gepflegt werden muss K rzel f r das Interface z B XBP XBP XMI Logging Firmenname eines externen Management Tools
164. 1 Feld NET CAT eingetragener Wert bs2000 servername Maske AVN002 Feld Job CAT eingetragener Wert bs2000 servername Dies bedeutet dass das Erstellen der Konfigurationsdatei entfallen kann wenn alle Server Jobs auf dem gleichen Rechner unter der gleichen Benutzerkennung ablaufen sollen und sowohl bei der Generierung als auch in der Maske AVNOOO f r Server Name STD angegeben ist Wenn ein server name f r einen Benutzerkreis auf NONE gesetzt wird k nnen Mit glieder dieses Benutzerkreises keine Jobs auf Rechnern des Server Systems ablaufen lassen Bei Angabe X FU f r ein Strukturelement in der Netzbeschreibung gelten die Angaben NET USER NET PASSWORD USER PASSWORD und JOB ACCOUNT f r den AVAS Agenten AVSSINCM Erstellen der Konfigurationsdatei Die Nutzung der Angaben eines Servers und damit der Zugang zu einer Server Benut zerkennung ist durch ein Kennwort gesch tzt das in der Netzbeschreibung Maske AVNO09 angegeben werden muss Wenn Jobs auf verschiedenen Rechnern und oder unter verschiedenen Benutzerken nungen gestartet werden sollen muss eine Konfigurationsdatei im BS2000 OSD er stellt werden F r jede Benutzerkennung unter der AVAS Jobs starten soll ist ein eige ner Eintrag der Konfigurationsdatei abzuspeichern Wenn Jobs auf verschiedenen Rechnern unter der gleichen Benutzerkennung gestartet werden sollen muss f r jeden Rechner ein eigener Server Name vergeben werden Die Server Namen m
165. 1 0B30 Job log Date Time MsgId No Text 20040926 133824 00 516 Job wurde gestartet 20040926 133824 00 550 Step 001 gestartet Programm ZZTESTOO Variante MAX9999 Benutzername EICH 20040926 133824 00 517 Job wurde beendet 505 U21462 J Z125 7 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung UNIX Jobs die aus AVAS unter BS2000 OSD gestartet werden Der Job BS2 EXT PRI job wird im UNIX Betriebssystem mit den Parametern gestartet die aus dem USER PAR FILE BS2 EXT PRI par bernommen wurden Er startet wiederum einen mySAP com Job mit dem Namen BS2EXT PRI Y der aus 3 Job Steps besteht e Im Job Step 1 wird das externe Programm Is ausgef hrt e Im Job Step 2 wird das ABAP 4 Programm RSPFPAR mit der Variante GW zum Ablauf gebracht e Im Job Step 3 wird abschlie end noch das externe Programm pwd ausgef hrt Die bergebenen Print Parameter gelten f r alle Steps eines Jobs Sie kommen aber nur bei Steps mit ABAP 4 Programmen die Listen produzieren zur Geltung Die Destination DEST BA40HELIOS muss in der Datei saprfc ini der Benutzer USER AVASS in der Datei sapuser ini gepflegt sein Die LOG Datei wird im Verzeichnis home eich avas avasr3 link LOG Dateien mit dem Namen BS2EXT PRI Y 1og angelegt Mit der UNIX Shell Variablen werden alle Parameter der Datei BS2 EXT PRI par ber nommen Zur bergabe des Programm Exit Codes an BS2000 AVAS wird das Programm avssinjv ver
166. 1 Einleitung Die Komplexit t und Arbeitslast der Rechenzentren nehmen st ndig zu Daher erfordert der DV Betrieb eine klare Strukturierung gro e Transparenz hohe Flexibilit t und eine stetige Produktivit tssteigerung Um dieses Ziel zu ereichen ist die Automation der Batchproduk tion ein wesentlicher Faktor Mit AVAS Auftragsverwaltungs und Abwicklungssystem steht ein Produkt zur Verf gung mit dem das Rechenzentrum seine Auftragsproduktion so weitgehend automatisieren kann dass Dialogeingaben auf ein Minimum reduziert werden Die Verlagerung der Batch produktion in unbediente Schichten wird erheblich erleichtert AVAS realisiert die Automatisierung der Planung Vorbereitung Freigabe Steuerung und berwachung von Batch Produktionsabl ufen im BS2000 OSD Die Verwaltungs und Steuerungsfunktionen von AVAS laufen ebenfalls im BS2000 OSD ab Von der BS2000 Plattform aus kann AVAS Jobs auf weiteren Systemen starten und kon trollieren e Im homogenen BS2000 Mehrrechner Verbund nutzt AVAS die HIPLEX MSCF Funktio nen zur Auftragsverteilung und berwachung e Durch Einsatz des Servers AVAS SV werden folgende Systeme an AVAS angeschlos sen entfernte BS2000 Systeme mit Anbindung ber die Socket Schnittstelle Solaris SPARC Systeme LINUX Systeme weitere UNIX Systeme Windows Systeme Systeme mit mySAP com e Auch beliebige andere Fremdsysteme k nnen an AVAS angeschlossen werden In allen F llen wird
167. 1 OCCURE VALUE CODE DESCRIPTION TYPE NET JOB RES MEANING C30ABE EQU 20 ABENDED C3OEND EQU 21 Sep Ele vk ENDED C3OERR EQU 22 ERROR 63051 EQU 62 imr SKIPPED C30IGN EQU 63 IGNORED C3OFRE EQU 107 Nee EREE C30USH EQU 118 re remp 4 SHARE C3ONPL EQU 124 I I I 1 I 0 PLA C3ODEL EQU 125 eh le DELETED C3ONSM EQU 33 5 1 NO SUBMIT 2 USED NOT USED C3CECO DS 2XL1 ERROR VALUE CODE 366 U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen 367 ED ED ED ED EXCLUSIVE O PLAN ED BMIT NOT USED RIANT IMUM gt MEANI REAT BEND DED RROR IPP GNOR ISSI Co m m 2 CH FREE SHARE DELET 0 SU D SELECT RESTART VA COND VALUE LOGIK RESERVED RECORD LENGTH MI NET JOB RES Externe Erstellung von AVAS Elementen 11 20 21 22 62 63 64 107 118 119 124 125 133 CL2 NC3A OF NC3A DESCRIPTION TYPE EQU QU ECH C m m mrmmrm III TI n m rn rm rn OA C DS DS DS EQU DS EQU m AD C3E C3 C3 C3 C3 C3 C3 C3 C3 C3 C3 C3 C3 m Co rm rm I UJ e Z3 O rn rm EE T x IL rn C25 TT FT FT FT FT FT m TT TT TT TT r tom Om Lo DHOO oO C3CSRV C3CVLG
168. 105172 AVAS U AVSCOBAN Aufl sung des COPY Elements AVSCOBAN 020225 005 COPY AVSCOBAN AVSCOBAN COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 A ALL RIGHTS RESERVED URE X 08 AVSNSRVN URE X 04 RE X 04 E X 04 E X 03 423 X 32 AVSNCNAM X 32 VSNCNAM X 30 X 02 VSNCNAM X 30 X 02 9 03 9 03 X 03 X X 04 X E X 30 E 0 gt mb m m m TH rn rr rn TT1 rn rn rmm rm mn mm rn rri rpm c C c 2 1 re ZZ TUR OD Go U 0 Lo 0 Geo DT DESCRIPTION M REDEFINE SNN REDEFINE FNA ER REDEFINE JNA ER 5 6 C E ABLDAT NET 07 AVSNANET AVSNCNA FILLER 5 AVS FILLER 5 AVS 15 FILL FILLER 5 AVS 15 FILL AVSNIND AVSNS AVSNSY AVSNS AVSNST2 AVSNST3 AVSNSTT AVSNEND AVSNFUN AVSNTYP
169. 2 Das sind z B Fehler die durch die Angabe einer ung ltigen Variante f r ein ABAP 4 Programm auftreten Fehler die nach dem Start auftreten f hren zum Programm Exit Code 3 Das ist z B der Fall wenn w hrend der Job Abarbeitung im mySAP com die Kommunikation zu mySAP com verloren geht Wenn der Job abgebrochen wird weil es z B Probleme bei der Ausf hrung externer Pro gramme gibt und der Job auf die Beendigung des externen Programms warten soll dann wird der Programm Exit Code 1 gesetzt Wenn der Job ordnungsgem beendet wird wird der Programm Exit Code 0 gesetzt U21462 J Z125 7 503 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung 11 5 6 Beispiel Jobs Vor dem Start von mySAP com Jobs aus BS2000 AVAS ist es sinnvoll den Betriebssystem Job der den avasr3 Aufruf enth lt als Standalone Job zu testen Beispiele f r Jobs die aus dem jeweiligen Betriebssystem gestartet werden und f r Jobs die aus BS2000 AVAS gestartet werden sind im Folgenden aufgef hrt Die aus BS2000 AVAS gestarteten Jobs sind in der Netz Beschreibung mit FUNCTION X und TYPE MOD definiert F r diese Jobs wird zus tzlich noch die USER PAR FILE Datei mit aufgef hrt 11 5 6 1 UNIX System Standalone UNIX Jobs Der UNIX Job zztest1 job startet einen mySAP com Job mit dem Namen 2215511 der aus einem Job Step besteht Im Job Step 1 wird das ABAP 4 Programm ZZTESTOO mit der Variante MAX9999 zum Ablauf gebrach
170. 2 J Z125 7 Cobol Schnittstelle 10 10 10 10 10 10 10 10 10 FUNCTION C LO 15 AVSNCVAL FUNCTION C 10 FUNCTION C 10 424 Cobol Schnittstelle TIMES TIMES IYPE RES FILLER REDEFINES AVSNVANF 5 AVSNCROC PICTURE X OCCURS 12 5 AVSNCREC PICTURE X OCCURS 12 TYPE VAL FILLER REDEFINES AVSNVANF 15 AVSNCVOS PICTURE X 128 15 AVSNCVES PICTURE X 128 IYPE TIM IYPE RES FILLER REDEFINES AVSNVANF 15 AVSNARVC PICTURE X TYPE VAL FILLER REDEFINES AVSNVANF PICTURE X 128 15 AVSNAVVA 425 PICTURE X 128 IYPE RES FILLER REDEFINES AVSNVANF 15 AVSNMRVC PICTURE X TYPE VAL FILLER REDEFINES AVSNVANF 15 AVSNMVVA TYPE RES TYPE VAL TYPE NET FILLER REDEFINES AVSNVANF 5 AVSNDNCN PICTURE X 32 IYPE JOB FILLER REDEFINES AVSNVANF 5 AVSNDJCN PICTURE X 32 15 1 PICTURE X 03 IYPE STD MOD EXT TYPE STD MOD EXT EXX TYPE STD MOD EXT FILLER REDEFINES AVSNVANF 15 AVSNCJLD PICTURE X 08 15 AVSNTSN PICTURE X 04 15 AVSNCJCR PICTURE X Programmschnittstelle von AVAS FUNCTION C 10 FUNCTION C 10 FUNCTION W t FUNCTION A 10 FUNCTION A 10 FUNCTION M 10 FUNCTION M 10 FUNCTION D FUNCTION D 10 FUNCTION D 10 FUNCTION J FUNCTION P FUNCTION X 10 U21462 J Z125 7
171. 21462 J Z125 7 359 Externe Erstellung von AVAS Elementen X X X OR OR U21462 J Z125 7 B RES VAL TIM MOD EXT STD DICAMDICAMDIW JPX tt ES LIST OF SELECT TURNUS SELECT TURNUS 0 9 OR X 40 lt DDDHHMM gt TAB 1 SEGM LENGTH TAB 1 SEGM COUNTER RESERVED LIST OF SYMDAT SYMDAT NAME LATEST START LATEST OCCURE lt DDDHHMM gt lt DDDHHMM gt LIFE TIME DELAY SOLUTION NET STR MEANING CANCEL MAIT START IGNORE D NOT USED RESERVED RECORD LENGTH MINIMUM TAB 2 SEGM LENGTH TAB 2 SEGM COUNTER PLAN DESCRIPTION FIELDS USED ONLY WHEN 7 DESRCIPTION TYPE JVA NET JO AND FUNCTION C C DIC LST LAST START LOC LAST OCCU LTI LAST TIME 050 DELAY SOLU JU1STL DS 10CL JISTE DS 0C ORG NJISTL JISEL DS C EQU NJISEL 11 ORG NJISTE EQU NJISTL NJ1 L1 71 DS CL2 JISYL DS 51CL36 JISYE DS 00 ORG NJ1SYL J1SYM DS CL20 1151 DS OCL7 J1LOC DS CEZ 1111 DS CL7 J1DSO DS X DELAY SOLUTION J1EDSC EQU 65 JIEDSW EQU 67 JlEDSS EQU 68 JIEDSI EQU 69 C USE DS E NJ1 L2 EQU NJ1SYM NJILMIN EQU NJ1A ORG NJISYE NJ1 Z2 EQU NJ1SYL NJ1 L2 DS OF NJIL EQU
172. 248 JVA VALUE S53CJVO DS X COND JVA OPTION LGOP AVASEQU S53 EQUNAME STD VERSION STD PE C S53CJVEQ EQU 0 ss B 0000 xxxx S53CJVSP EQU Gr BLANK B 0100 0000 S53CJVNE EQU X FO NE B 1111 xxxx S53CJVLT EQU X 70 E B 0111 xxxx S53CJVLE EQU X BO SE B 1011 xxxx S53CJVGE EQU X DO B 1101 xxxx S53CJVGT EQU X EO GT B 1110 xxxx 5353L EQU 853853A LAENGE DER DATE S53LEN EQU N3JRNS U21462 J Z125 7 207 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Definitionen Satzschl ssel 54 ORG N3INH S54 AVASJRN S54 7 JOURNALSATZ SATZSCHLUESSEL 54 STR ELEMENT ABLDAT ERSETZT SATZSCHLUESSEL 44 AB VERSION 02 0A 7 khe ek kk kk e he ke 5545548 DS 0C SATZBESCHREIBUNG SATZ 54 S54TYPT DS 0CL3 TYPE TEXT S54TYP DS X TYPE CODE DS CL2 S54SRT DS CL3 START INDEX
173. 4 leerer Satz 16 07 Ende Modifikation FU J P X 16 08 Abbruch Modifik FU J P X 01 07 Ende der Funktion 01 08 Abbruch der Funktion 09 08 Fehlermeldung EDIT PROD JOB Start der Funktion 0 65 01 JCL Anweisung alt 65 02 JCL Anweisung neu 65 04 JCL Anweisung gel scht 16 07 Ende der Funktion 16 08 Abbruch der Funktion 09 00 Fehlermeldung ODIFY PROD NET 01 00 Start des L schens 16 04 L schen Job 16 05 Fehler beim L schen 01 07 Ende der Funktion 01 08 Abbruch der Funktion 09 00 Fehlermeldung DELETE PROD NET 01 00 Start des L schens 16 00 L schen Job 16 05 Fehler beim L schen 01 07 Ende der Funktion 01 08 Abbruch der Funktion 09 00 Fehlermeldung U21462 J Z125 7 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation SSL FNR Anweisung Ausgabe im Datenbereich SUBMIT NET 31 00 Start Netzfreigabe S31 AVASJR 32 00 Ausgabe Strukturelement mit S32 AVASJR x FU J P X 32 04 L schen Strukturelement mit S32 AVASJR x FU J P X 32 05 Ausgabe Strukturelement mit S32 AVASJRN x FU J P X Error 25 01 JCL Anweisung alt Anweisung JMDLIB x 25 02 JCL Anweisung neu Anweisung EX7102 x 25 04 JCL Anweisung l schen Anweisung JMDLIB x 25 05 JCL Anweisung Error Anweisung EX7102 x 25 09 JCL Anweisung EXIT ERROR Anweisung EX7102 x 54 00 Ausgabe Strukturelement mit S54 AVASJR x FU A C D M W 54 04 L schen Strukturelement mit S54 AVASJR x FU A C D M W 31 02 Wechsel
174. 8 Installation und Generierung Generierung des AVAS Systems e Ein Benutzerkreis wird mit dem Schl sselwort BK definiert Diese Definition ist so oft anzugeben wie Benutzerkreise im AVAS System ben tigt werden Die Anzahl der BKs ist nicht begrenzt Die in Klammern anzugebenden Werte m ssen in der unten beschriebenen Reihenfolge geordnet sein BK bk NETnnn JCLnnn calendar avak avak use server name bk Name eines Benutzerkreises maximal 4 Zeichen davor muss das Zeichen sein NETnnn Schl sselwort der Benutzerbibliothek f r Netzbeschreibungen Netzbibliothek JCLnnn Schl sselwort der Benutzerbibliothek f r Jobs und JCL Bausteine JCL Bibliothek calendar Name des Kalenders maximal 20 Zeichen Element der Kalender bibliothek CALLIB der standardm ig dem Benutzerkreis zugeord net ist avak Name der Standardablaufsteuerung dieses Benutzerkreises RUN CONTROL SYSTEM maximal 8 Zeichen avak use Angabe wie Namen von Ablaufsteuerungen verwendet werden STD Die Benutzer dieses Benutzerkreises d rfen nur den hier definierten Namen der Standardablaufsteuerung oder STD verwenden Wenn Netze fremder Benutzerkreise bearbeitet werden kann der Name der Ablaufsteuerung nur in STD oder in den Namen der eigenen Ablaufsteuerung ge ndert wer den Wenn ein Benutzer Netze eines fremden Benutzerkreises mit COPY NET DESCRIPTION kopiert oder beim Kopie ren mit COPY ELEMENT MODE LIBIN den Benutzer kreis
175. ACCN Eingabe Ausgabe Parameter Abrechnungsnummer der BS2000 Benutzerkennung des ENTER Aufrufs pfixPASW Eingabe Ausgabe Parameter Kennwort der BS2000 Benutzerkennung des ENTER Aufrufs pfixEFIL Ausgabe Parameter Name der ENTER Datei pfixECAT Ausgabe Parameter Verweis auf einen Slave Rechner Wert nur vorhanden wenn eine Katalogkennung CATID ermittelt wurde pfixSIID Eingabe Ausgabe Parameter U21462 J Z125 7 84 Installation und Generierung RZ Exits im AVAS System Symbolischer Name des Server Partners zu dem der Auftrag gesendet werden soll SERVER NAME pfixSIPW Eingabe Ausgabe Parameter Kennwort das zur Adressierung dieses Partners berechtigt SERVER PASSWORD pfixJTYP Eingabe Ausgabe Parameter Typ des Jobs z B MOD STD pfixFUNC Eingabe Ausgabe Parameter Funktion des Jobs z B J P X pfixJPAR Eingabe Ausgabe Parameter Parameterwert f r JOB PARAMETER beim BS2000 Kommando ENTER JOB bzw ENTER PROCEDURE Hinweis F r Server Jobs beziehen sich die Felder pfixUSID pfixACCN und pfixPASSW auf den AVAS Agenten AVSSINCM Sie geben an unter welcher Benutzerkennung Abrechnungsnummer und welchem Kennwort AVSSINCM gestartet werden soll Wenn pfixSIID und pfixSIPW gel scht werden kann der Auftrag nicht an einen Server Partner bergeben werden da kein Eintrag in der Konfigurationsdatei adressiert wer den kann Am RZ Exit AVEX0401 werden die Werte f r Benutzerkennung Abrechnungsnummer un
176. ACID Aufl sung des Makros AVSASSRT AVSASSRT MFCHK MF C PREFIX A MACID VSE DMACID VSE SUPPORT C D OF JHHHHE PREFIX A MACID VSE 3HHHHE RESULT DESCRIPTION 0CL96 CL64 AVSEOPAR CL32 NET NAME 0CL12 EARLIEST START NEW PLAN START CL6 DATE CL6 TIME CL20 SYMDAT NAME CL3 RESERVED AVSEOPAR CL32 C RESTART VARIANT CL31 AVSEOPAR CL43 ELEMENT NAME CL21 AVSEOPAR CL30 CONDITION NAME CL34 U21462 J Z125 7 DS DS DS ORG DS DS DS DS DS DS ORG DS DS DS ORG DS DS ORG DS DS AVSERSLT AVSEOPAR AVSENETN AVSEEAS AVSEEASD AVSEEAST AVSESYND AVSERSVT AVSENAME AVSECDNM 416 Assembler Schnittstelle RESERVED RESULT CODE ARTIALLY REATED RESERVED 417 Programmschnittstelle von AVAS CL3 0CL13 X LO 1 14 22 27 ER 124 127 129 130 33 38 39 CL12 CL16 0C DS DS DS T1 r C CO CH est UOrmrimm Im TT rm rnm rmrrmr rmn en m Co QOO QO O QOO O O O 00090 C C co co LTC RLT R AVSE AVSE AVSQPART RE RR EST LA OPL PDT OUP 05 OFO 0 R P U AVSQ AVSQSUB AVSQE AVSQ AVSQ AVSQ AVSQSAVE AVSQ AVSQ AVSQ AVSQ AVSQLCKD AVSERLTT U21462 J Z125 7 Cobol Schnittstelle Programmschnittstelle von AVAS 10 4 Cobol Schnittstelle 1 Aufruf der Cobol
177. AIT FOR CONDITION STATE NET JOB AVSBCOST DS CL128 WAIT FOR CONDITION VALUE DS CL2 RESERVED DS 0C 410 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Schnittstelle AVSASSJD Journal Inhaltsverzeichniseintrag definieren Makro Parameter AVSASSJD MF C D PREFIX A char 1 gt MACID VSJ char 3 gt EQU NO YES Parameter MF und PREFIX siehe AVSASSAD auf Seite 389 MACID Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Standardwert VSJ EQU Steuert die Generierung von Equates f r die Schl sselw rter NO Es werden keine Equates generiert YES Es werden die Equates f r die Schl sselw rter generiert Hinweis Der Makro AVSASSJD generiert eine Verl ngerung des Ausgabebereichs Er muss daher im Anschluss an den Makro AVSASSBO aufgerufen werden U21462 J Z125 7 411 Assembler Schnittstelle Programmschnittstelle von AVAS Aufl sung des Makros AVSASSJD AVSASSJD MFCHK MF C PREFIX A MACID VSJ DMACID VSJ SUPPORT C D DS OF AHHHHE PREFIX A MACID VSJ fHHHHE e JRNDAT NET DIRECTORY DESCIPTION AVSJJDIR DS 00164 JOURNAL DIRECTORY DESCRIPTION AVSJNETN DS CL32 BK NETNAME PLANSTARTDATE PLANSTARTTIME AVSJNSTI1 DS X STATE 1 NET SUBMITTED AVSJNST2 DS X STATE 2 NET STATE AVSJNST3 DS X STAT
178. AIT zum Start des Zugriffsprozesses UPAM ZD siehe Seite 109 Die kritischen Anweisungen CREATE PLAN NET CREATE PROD NET SUBMIT NET und REPEAT NET werden ber Warteschlangen serialisiert Damit ergeben sich folgende Warteschlangen e Warteschlange der BATCH Prozesse Wenn bei MAX BATCH PROCESS n mehr als n BATCH Prozesse gestartet werden kommen nur n Prozesse zur Verarbeitung Alle weiteren werden in eine Warteschlange eingereiht e Warteschlange der Anweisung CREATE PLAN NET e Warteschlange der Anweisung CREATE PROD NET e Warteschlange der Anweisungen SUBMIT NET und REPEAT NET 158 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb Beispiel Die Funktion SUBMIT NET gibt vor dem Ablauf der kritischen Verarbeitungsfolge einen Serialisierungsbegriff an die UPAM ZD Dies f hrt dazu dass mit diesem Begriff die Verar beitung exklusiv bis zur Endemeldung kontrolliert durchgef hrt wird Ein zweiter Funktionsprozess mit der Funktion SUBMIT NET und dem gleichen Serialisie rungsbegriff muss in der UPAM ZD solange warten bis die exklusiv arbeitende Funktion zu Ende ist Zwischen dem zweiten Funktionsprozess und der UPAM ZD findet w hrend der Wartezeit keine Kommunikation statt Die maximale Wartezeit wird ber die Anweisung MAX SERIAL WAIT vorgegeben Dieses Verfahren serialisiert Verarbeitungsfolgen eines Funktionsprozesses Eine Still standsituation kann nur entstehen wenn ein Funktionsprozess der m
179. ALL userid Standardwert MARENAV w hlt nur VSNs aus die im Archiveintrag den angegebenen Dateinamen besitzen und die entweder der Benutzerkennung aus dem Dateinamen oder der Ablaufkennung zugeordnet sind Die Ablaufkennung wird wie folgt ermittelt Wenn im AVAS Kommunikationsbereich das Feld nameJENT mit dem Wert nameJENTJ versorgt ist Angabe ENTER PARAMS NET in der Netzbeschreibung wird die im Feld nameJUSE vorhandene Kennung verwendet Wenn das Feld nameJENT jedoch den Wert nameJENTL enth lt Angabe ENTER PARAMS LOGON in der Netzbeschreibung stellt die im Kommando SET LOGON PARAMETERS angegebene Kennung die Ablaufkennung dar Mindestens an einer dieser 3 Stellen muss eine Kennung vorhanden sein sonst wird die Produktionsfreigabe abgebrochen Wie mit dem Wert userid so wird auch mit OWN eine kennungsspezifische Auswahl getroffen Der Wert OWN bietet jedoch den Vorteil der Jobneutralit t d h bei einem Wechsel der Kennung ist keine Anderung der JCL bez glich des Komman dos REMARK UID notwendig Bei der Auswahl der VSNs werden die Kennungen unter der diese im MAREN Katalog eingetragen sind nicht ber cksichtigt Dieser Parameter ist zu w hlen falls bei den in einem Rechenzentrum eingesetzten Verfahren die M glichkeit besteht die einzelnen Versionen ein und derselben Datei unter verschiedenen Kennungen zu erstellen MARENAV w hlt nur VSNs aus die im Archiveintrag den angegebenen Dateinamen besitzen u
180. AMCONV V12 0A PASSWORD V15 0A PVSREN V2 0A RMS V7 1E SCDM V6 0A SMPGEN V15 0A SPCCNTRL V15 0A TPCOMP2 V15 0A VOLIN V15 0A Bestellnummer U4303 J Z125 8 U21462 J Z125 7 Literatur 3 4 5 540 Literatur 6 BS2000 OSD BC V6 0 Einf hrung in das DVS Benutzerhandbuch Zielgruppe Das Handbuch wendet sich an nichtprivilegierte Anwender und an die Systembetreuung Inhalt Es beschreibt die Dateiverwaltung und verarbeitung im BS2000 Themenschwerpunkte Datentr ger und Dateien Datei und Katalogverwaltung Datei und Datenschutz OPEN CLOSE EOV Verarbeitung DVS Zugriffsmethoden SAM ISAM Bestellnummer U4237 J Z125 8 7 BS2000 OSD BC V6 0 Einf hrung in die Systembetreuung Benutzerhandbuch Zielgruppe Das Handbuch wendet sich an die Systembetreuung und das Operating Inhalt Es sind u a folgende Themen zur Verwaltung und berwachung des BS2000 OSD Grundausbaus enthalten Systemeinleitung Parameterservice Job und Tasksteuerung Speicher Ger te Benutzer Datei Pubset und Systemzeit Verwaltung Privilegienvergabe Accounting und Operatorfunktionen Bestellnummer U2417 J Z125 15 B FHS DOORS BS2000 OSD MS Windows Grafische Oberfl che f r BS2000 OSD Anwendungen Benutzerhandbuch Zielgruppe Entwickler die BS2000 Anwendungen mit einer grafischen Oberfl che ausstatten Inhalt Das Handbuch beschreibt das Nutzungsmodell und die Funktione
181. AME der zur Auswahl f hrte Verschl sselungen einzelner Felder z B AVSERLTO sind im Makro AVSASSRT bzw im COPY Element AVSCOBCOQ beschrieben READ AVAS LIBRARY Abh ngig von den Parametern NET NAME bzw CONDITION NAME und AVAS USER LIBRARY werden unterschiedliche Ergebnisse aufbereitet Parameter AVAS USER LIBRARY ABLDAT und NET NAME group In der Ergebnistabelle wird f r jedes Netz ein Eintrag gem Makro AVSASSAD bzw COPY Element AVSCOBAD abgelegt Parameter AVAS USER LIBRARY ABLDAT und NET NAME netname In der Ergebnistabelle wird pro Netzstrukturelement ein Eintrag gem Makro AVSASSAN bzw COPY Element AVSCOBAN abgelegt U21462 J Z125 7 383 Aufbau der Verst ndigungsbereiche Programmschnittstelle von AVAS Parameter AVAS USER LIBRARY ABLDAT und CONDITION NAME group In der Ergebnistabelle wird f r jedes Ereignis ein Eintrag gem Makro AVSASSCD bzw COPY Element AVSCOBCD abgelegt Parameter AVAS USER LIBRARY ABLDAT und CONDITION NAME condname In der Ergebnistabelle wird pro Ereignis ein Eintrag gem Makro AVSASSCE bzw COPY Element AVSCOBCE abgelegt Parameter AVAS USER LIBRARY JRNDAT und NET NAME group In der Ergebnistabelle wird f r jedes Netz ein Eintrag gem Makro AVSASSJD bzw COPY Element AVSCOBJD abgelegt Parameter AVAS USER LIBRARYZJRNDAT und NET NAME netname In die Ergebnistabelle wird f r jeden Journaleintrag ein Eintrag gem Makro AVSASSJN bzw COPY Element
182. ANCEL tsn zu beenden weil dabei inkonsistente Statusinformationen in den AVAS Dateien ABLDAT und JRNDAT auftre ten k nnen 120 U21462 J Z125 7 Administration von AVAS Starten und Beenden der AVAS Prozesse 3 1 5 Starten und Beenden des Prozesses Server berwachung Jobs die auf einem momentan nicht verf gbaren Server zum Ablauf gebracht werden sol len erhalten den Status HOSTWAIT Diese Funktion entspricht der Funktion HOSTWAIT f r BS2000 Rechner im MSCF Ver bund Da es f r die berwachung der Server keine BS2000 Systemfunktion gibt werden analog zu MSCF die Status der zu berwachenden Server ebenfalls ber Kontrolljobvari ablen kurz SV JV angezeigt F r jeden in der Konfigurationsdatei eingetragenen Servernamen ist unter der BS2000 Kennung der Ablaufsteuerung eine Jobvariable mit den Namen AVS SERVER STATE lt server jv link name gt lt server name gt anzulegen Der Prozess Ser ver berwachung siehe Abschnitt Prozess Server berwachung auf Seite 486 legt die Server Jobvariablen selbst ndig an F r jeden Server gibt es eine AVAS Server Jobvariable die der Ablaufsteuerung zur Kon trolle der Betriebsbereitschaft eines Servers dient Das Aktualisieren der Server Kontroll jobvariablen wird ber den AVAS Prozess Server berwachung realisiert In der Startprozedur der Ablaufsteuerung ist ber den Parameter SERVER JV LINK mitzu teilen ber welchen Link Namen die Ablaufsteuerung die Server Jobvariable find
183. AR2 AVSCERJN DS CL30 ERROR JOBNAME AVSCERIN DS CL3 ERROR INDEX AVSCRSVT DS CL1 RESTART VARIANT DS CL62 ORG AVSCPAR2 AVSCUSLB DS CL6 AVAS USER LIBRARY AVSCNSTI DS CL12 NET STATUS AVSCCDNT DS CL3 CONDITION TYPE AVSCCDNM DS CL30 CONDITION NAME AVSCCDNN DS CL32 CONDITION CREATED BY NET NAME AVSCCDNI DS CL3 CONDITION CREATED BY INDEX DS CL10 402 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Schnittstelle PARAMETER AREA 3 AVSCPAR3 DS OCL96 AVSCLTI DS CL19 LIFE TIME AVSCCDVL DS CL74 CONDITION VALUE DS CL3 AVSR QCL EQU AVSRAREA LNG COMMUNICATION AREA U21462 J Z125 7 403 Assembler Schnittstelle Programmschnittstelle von AVAS AVSASSBO Kopf des Ergebnisbereichs definieren Makro Parameter AVSASSBO MF C D PREFIX A char 1 gt MACID VSO char 3 gt Parameter MF und PREFIX siehe AVSASSAD auf Seite 389 MACID Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Standardwert VSO Aufl sung des Makros AVSASSBO AVSASSBO MFCHK MF C PREFIX A MACID VSO DMACID VSO SUPPORT C D DS OF AHHHHE PREFIX A MACID VSO fHHHE AVAS BATCH PROGRAM INTERFACE OUTPUT AREA AVSOAREA DS 0C AVSONECT DS H COUNTER OF MAX TAB OUTPUT DS CL10 RESERVED AVSOFILE DS CL54 FILENAME OF TAB OUTPUT DS CL14 RESERVED A
184. AS Anweisung AVJ signalisiert wird Wenn das Ende nicht signalisiert wird bleibt der Auftrag und damit das Netz im Status RUNNING Es kann nur ber CANCEL NET in den Status ERROR oder ABENDED gebracht werden 444 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Installation von AVAS SV 11 1 Installation von AVAS SV Die Varianten des AVAS Servers AVSRECV f r UNIX bzw Windows Systeme werden von einer MultiCD installiert Diese CD beinhaltet die Installations und Produktsoftware f r AVAS SV mit der Zusatzfunktion zum Steuern und berwachen von mySAP com Jobs AVAS R3JobControl und die grafische Oberfl che AVAS DOORS 11 1 1 Installation auf UNIX Plattformen Die ISO9660 Norm erlaubt es auf demselben Datentr ger Produktpakete unterschied licher Betriebssysteme zu speichern Als Einstieg in die AVAS Installation von CD ROM s mtlicher UNIX Rechner wurde des halb die einheitliche Installationsprozedur install avs geschaffen Sie wird auf jeder unter st tzten UNIX Plattform in dem Verzeichnis aufgerufen in dem die CD ROM vorher per Mount verbunden wurde 11 1 1 1 Installation von AVAS SV und von AVAS R3JobControl auf Solaris SPARC Die Installation von AVAS SV auf Solaris SPARC erfolgt mit install avs Auch auf diesem System muss eine CD ROM gemountet werden damit auf ihre Daten zugegriffen werden kann Verzweigen Sie auch hier nach dem Mounten in das Verzeichnis lt MountPunkt gt und star ten Sie d
185. AS Systems d rfen die Ablaufsteuerungen erst starten wenn die Server berwachung die SV JVs auf den aktuellen Stand gebracht hat Status READY e Zwischen dem Ausfall eines Servers und dem Setzen der SV JV vergeht Zeit in Gr Benordnung der eingestellten SV CONTROL TIME Server Jobs die gestartet werden bevor die SV JV auf T gesetzt werden kann erhalten den Status ERROR Um die An zahl der Jobs mit Status ERROR wegen eines Serverausfalls gering zu halten st t das Programm AVSSINCM bei einem fehlgeschlagenen Verbindungsaufbau einen neu en berwachungszyklus an Beenden der Server berwachung Die Server berwachung wird durch die Operation SHUTDOWN beendet Die Eingabe erfolgt ber MODIFY JV JV IDENT JV NAMECjvname VALUE C SHUTDOWN ab der ersten Stelle der berwachenden Jobvariablen Prozedur zum Anzeigen der aktiven REP Korrekturen Die aktiven REP Korrekturen der AVAS Biblotheken SYSLNK AVAS 070 SYSPRG AVAS 070 SYSTEM und SYSPRG AVAS 070 DIALOG k nnen mit der Prozedur SYSPRC AVAS 070 SCANREPS aus der Bibliothek SIPLIB AVAS 070 angezeigt werden Prozedur zum Anzeigen der Status und Versionen der konfigurierten AVAS Server Die Status oder die Versionen der in der CONFIG Datei konfigurierten AVAS Server k n nen mit der Prozedur SV SVSTATUS aus der Bibliothek SYSPRC AVAS 070 angezeigt wer den Die Status werden angezeigt beim Wert STATUS f r den Startparameter INFORMATION die Versionen bei INFORMATION VERS
186. ATENBANK gt gt avsquer Datenbank ausw hlen oder Namen eingeben Weiter mit RETURN SQL Dialog Datei Laden Sichern oder L schen einer Anweisungsdatei DATEI Laden Dialoganweisung aus einer Anweisungsdatei einlesen AUSWAHL insert Anweisungsdatei ausw hlen oder den Namen eingeben Weiter mit RETURN SQL Dialog START Dialoganweisung ausf hren SQL Dialog Neu Neue Dialoganweisung eingeben SQL Dialog START Dialoganweisung ausf hren U21462 J Z125 7 245 Datenhaltung f r AVAS QUER Dienstprogramm AVAS QUER 5 3 Datenhaltung f r AVAS QUER 5 3 1 Erstellen der Datenbank Der Name der Datenbank die mit diesen Anweisungen erstellt wird lautet avsquer und kann vom Benutzer ge ndert werden Der Name der Datenbank ist in den ersten beiden Zeilen der Datei enthalten CREATE DATABASE avsquer DATABASE avsquer Die sich daran anschlie enden Anweisungen zum Erstellen der Datenbanktabellen d rfen nicht ge ndert werden Die SQL Anweisungen k nnen z B mit INFORMIX isgl Men SQL Dialog Men punkte Datei und START zur Ausf hrung gebracht werden Von isql werden diejenigen Dateien im Men punkt Datei zur Auswahl angeboten deren Name mit sql endet 5 3 2 Einbringen der Daten Der Benutzer muss die von AVAS QUER erstellte n Ausgabedatei en durch Filetransfer auf das gew nschte Zielsystem bertragen Einbringen der Daten in die INFORMIX Datenbank
187. AVAS Server ermittelt Die Server berwachung schickt Nach richten an die zu berwachenden Server und wartet auf deren Antworten Sendet der angesprochene Server eine Antwort wird in der zugeordneten SV JV statt U der Wert R eingetragen Bleibt die Antwort aus erh lt die SV JV den Wert ST 122 U21462 J Z125 7 Administration von AVAS Starten und Beenden der AVAS Prozesse In Abh ngigkeit des Eintrags eines Servers in der Konfigurationsdatei und des Vorhan denseins einer SV JV f r den jeweiligen Server f hrt die Server berwachung folgende Ak tionen aus Bearbeitung von SV JVs durch die Server berwachung Server in Konfi SV JV vor Aktionen gurationsdatei handen ja ja SV V wird auf U UNDEFINED gesetzt beim Starten SV JV wird auf R RUNNING gesetzt wenn Server ant wortet SV JV wird auf T TERMINATED gesetzt wenn Server nicht antwortet ja nein SV JV wird angelegt mit den Attributen mehrfach benutzbar Schreibrecht f r eigene Kennung Leserecht f r alle SV V wird auf U UNDEFINED gesetzt beim Starten SV JV wird auf R RUNNING gesetzt wenn Server ant wortet SV JV wird auf T TERMINATED gesetzt wenn Server nicht antwortet nein ja SV JV wird gel scht SV JV wird auf D DELETED gesetzt falls L schen nicht m glich Zyklische berpr fung der Server Die Server werden beim Starten der Server berwachung berpr f
188. AVS JOB PARAMETER ECL PARAM AVS USER ACCOUNT ECL PARAM AVS USER ID ECL PARAM AVS USER PASS ECL PARAM AVS DEF COMM PASSW ECL PARAM AVS DEF DIRECTORY ECL PARAM AVS DEF HOST NAME ECL PARAM AVS DEF SERVER PASSW D D Tz x T2 Tad ra SOA E DACH i E tt Ue M Tei II ECL PARAM AVS DEF SERVER VERS ECL PARAM AVS DEF PORT NUMBER ECL PARAM AVS DEF USER ID ECL PARAM AVS SVDOG JV D PARAMETER DECLARATION D PASSWORD PASSWORD amp AVS CONF PASSW Tal II k Tz x Tz x UC U U U uU GE CG U EE ZK EX ET Fe EL j III DIS 62 9 02 69 m Na ei ii s e Tee en ig XR ss Te an e en a ee re a gt m c U21462 J Z125 7 463 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung LINK NAME AVSXID SET FILE LINK FILE NAME amp AVS CONF FILE ACCESS METHOD ISAM KEY LEN 9 KEY POS 5 ASSIGN SYSDTA SYSCMD START PROG FROM FILE MODULE ELEMENT AVAS SYS LOAD SINCM LIBRARY amp USERID SYSPRG AVAS 070 SVCOMM RUN MODE ADVANCED PROGRAM
189. Ablaufdatei definieren 409 Benutzer Berechtigungen definieren 33 Definition 30 privilegierter 33 Systemvariable definieren 34 verwalten 127 135 Benutzerdateien 53 Reorganisation 163 symbolische Namen 53 Benutzerkennung f r Band reservieren 265 Benutzerkreis 528 Definition 27 29 Berechtigung O Berechtigung 33 1 Berechtigung 33 eines Benutzers ndern 33 Betrieb der AVAS Ablaufsteuerung 104 Bibliothek CALLIB 54 DOCLIB 54 DOCSYS 54 JCLSYS 54 JMDSYS 54 LOGSYS 54 MAPLIB 54 NETLIB 54 NETSYS 54 NPRLIB 54 Bibliotheken f r JCL Bausteine JCLLIB 54 f r Jobs JCLSYS 54 systemweit verf gbare 56 Binderanweisungen 74 f r Exit Modul 77 bk 29 BS2000 Server Ablaufsteuerung 442 U21462 J Z125 7 Stichw rter AVS JOB INDEX 465 AVS JOB LOG 466 AVS JOB NAME 465 AVS JOB PARAMETER 466 AVS JOB TYPE 465 avslog 136 493 AVS MONJV PASSW 465 AVS NET NAME 465 AVS PARTNER PASSW 466 AVSRECV AVAS Server 454 im Server System starten 522 installieren 445 starten 474 AVS SERVER NAME 466 AVS SERVER VERSION 466 AVSSINCM AVAS Agent 454 456 starten 463 Startparameter 465 Startprozedur 463 AVSSINJV 492 im Server Script aufrufen 492 AVSSTRT 441 abbrechen 517 AVAS Agent 472 CANCEL 517 Nachricht analysieren 472 AVS SVDOG JV 7 AVS SV PARAM 466 AVS SYSTEM ID 466 AVS USER ACCOUNT 466 AVS USER ID 466 AVS USER PASSW 466 avuser 30 B Band reservieren 265 Bandmontierliste 271 BATCH Anweisungen 528
190. Anweisung und die Namen der Parameter zum Teil verk rzt ein gegeben werden Alle ber die INFORM PROG Kommandos angesto enen Aktionen bez glich der Netze werden im Journal protokolliert Bei Fehlern erfolgt eine Meldung auf dem Bedienplatz wo bei Meldungen ohne Netznamen immer von einer Meldung mit Netznamen abgeschlossen werden 130 U21462 J Z125 7 Administration von AVAS Bedienen und berwachen der AVAS Prozesse Aktualisieren der AVAS Internen Rechnertabelle Die Ablaufsteuerung ermittelt beim Hochfahren aus dem MRSCAT anhand der MSCF Job variablen die zu unterst tzende Rechner Pubset Konfiguration Die Ablaufsteuerung f hrt diese Konfigurationsdaten in einer eigenen Rechner Tabelle Bei den AVAS Servern wird anhand der SERVER Jobvariablen analog verfahren nderun gen im laufenden Betrieb bez glich der Rechnerkonfiguration k nnen der Ablaufsteuerung ber den INFORM PROG Aufruf mitgeteilt werden Dabei erfolgt die Aktualisierung der Rechner Tabelle Laufende Auftr ge auf Hosts bzw Servern die nicht mehr im Verbund enthalten sind wer den abgebrochen und erhalten den Status ERROR Die ONEVT Ereignisse zur berwachung der MSCF SERVER Jobvariablen werden aktua lisiert bersicht der INFORM PROG Kommandos zum Aktualisieren der AVAS Rechner tabelle INFORM PROG MSG UHOST JOB ID lt tsn gt Aktualisieren der Tabelle der MSCF Rechner INFORM PROG MSG USERVER JOB ID lt tsn gt Aktualisieren der Ta
191. Auch die Programme SIGNAL und TRANSFER werden im Rah men des Produkts AVAS SV BS2 f r den Einsatz auf einem entfernten BS2000 System zur Verf gung gestellt Der allgemeine Verfahrensablauf ist im Abschnitt Ablaufsteuerung und kontrolle von Ser ver Jobs auf Seite 454 beschrieben U21462 J Z125 7 442 AVAS SV Plattform bergreifende Jobsteuerung Auf jedem BS2000 Server System auf dem AVAS Auftr ge abwickeln soll muss der Server AVSRECV ladbar sein Die Adresse und Portnummer des Rechners m ssen in ei ner Konfigurationsdatei in der AVAS Kennung im BS2000 OSD eingetragen sein Die Zu gangsberechtigung zu AVSRECV wird ber das Kennwort gepr ft das unter comm pw in der Konfigurationsdatei angegeben ist AVSRECV startet die Jobs in gleicher Weise wie die Ablaufsteuerung im lokalen System F r die gestarteten Jobs ist die Ablaufinformation bis zur bergabe an das lokale AVAS in einer eigenen Datenhaltung gespeichert Damit ist Datensicherheit auch bei einem m g lichen Netzausfall oder Verbindungsverlust gew hrleistet Wie bei den Server Jobs f r UNIX oder Windows Systeme wird bei erneuter Verbindungs aufnahme mit RESTART NET der aktuelle Jobstatus ermittelt Bereits beendete Jobs erhal ten das entsprechende Ergebnis bei noch nicht beendeten Jobs wird auf das Jobende ge wartet Die Jobs k nnen ohne nderung vom lokalen BS2000 System auf das entfernte BS2000 Server System umgelenkt werden Notwendig ist n
192. B Ausgabe Parameter Schl ssel f r ENTER Parameter EQUATE f r ENTER Parameter aus LOGON Anweisung EQUATE f r ENTER Parameter aus Netz Job Beschreibung Ausgabe Parameter Verweis auf einen Slave Rechner Wert nur vorhanden wenn NET CAT oder JOB CAT im Netz beschrieben Ausgabe Parameter BS2000 Benutzerkennung f r ENTER Aufruf Wert nur vorhanden wenn pfixJENT pfixJENTJ und Benutzerkennung im Netz oder Job beschrieben 99 folgt pfixNNAM pfixEARL pfixLATS pfixLIFT pfixNTYP pfixNDSO pfixRCSY pfixJIND pfixJNAM pfixJENT pfixJENTL pfixJENTJ pfixJCAT pfixJUSE U21462 J Z125 7 RZ Exits im AVAS System Installation und Generierung pfixOPST Ausgabe Parameter Operateur Start Y YES N NO pfixJREC Ausgabe Parameter Satzbereich der JCL Anweisung pfixJRLG Eingabe Ausgabe Parameter L nge der JCL Anweisung maximal 256 Stellen plus 4 Stellen f r die Felder JRLG und JRES pfixJRES Ausgabe Parameter reservierter Bereich pfixJRSE Ausgabe Parameter JCL Anweisung Wenn alle Jobs eines Netzes bearbeitet worden sind ruft AVAS die RZ Routine nochmals auf Bei diesem Aufruf werden folgende Informationen bergeben abweichend von den im Kommunikationsbereich beschriebenen Feldern pfixJIND C 000 keine Indexstufe pfixJRLG X 0000 keine L nge der JCL Anweisung pfixJNAM wird nicht bergeben 100 U21462 J Z125 7 RZ Exits im AVAS System Installation und Generierun
193. BATCH und Programm schnittstelle Die Aktion wird von der Ablaufsteuerung umgesetzt wenn der Netzstatus und der Verarbeitungszustand es zulassen X 00 LOW Es ist keine Aktion gefordert X 17 HOLD X 1C RESUMED X 41 CANCEL NST3 X Sicherung des aktuellen Verarbeitungsstatus NST1 wenn die Netzver arbeitung unterbrochen ist NST1 HOLD oder NST1 RESUMED X 00 LOW Es ist kein Status gesichert X 16 ERROR X 18 RUNNING X 19 WAITING X 1A CONDWAIT X 1B RESTARTED X 3D OPWAIT X 44 START X AD HOSTWAIT Beispiel NST1 NST2 3 X 18 X 17 X 00 RUNNING HOLD LOW Das Netz befindet sich im Ablauf ber die Dialogfunktion wurde HOLD NET gefordert U21462 J Z125 7 391 Assembler Schnittstelle Programmschnittstelle von AVAS NST1 NST2 3 X 17 X 00 X 18 HOLD LOW RUNNING Es befindet sich kein Job im Ablauf Es kann kein Strukturelement mehr verarbeitet wer den weil HOLD gesetzt ist Ob sich dar ber hinaus Strukturelemente im Status ERROR NO OCCURE CONDWAIT oder HOSTWAIT befinden oder ein Restart eingeleitet wurde kann ber die Netzstatus Schalter NET STATE SWITCH ermittelt werden ET STATE SWITCH ERR X Zeigt an ob sich Strukturelemente im Status ERROR befinden RST X Zeigt an ob f r Strukturelemente ein Restart eingeleitet wurde CWT X Zeigt an ob sich Strukturelemente im Status NO OCCURE befinden HTW X Zeigt an ob sich Strukturelemente im Status HOSTWAIT befinden HLD X Zeig
194. Berechtigung in AVAS nur f r die dem Benutzer zugeordneten Bibliotheken gilt 5 2 Anweisungen von AVAS QUER Dieses Kapitel enth lt die Beschreibung der AVAS QUER Anweisungen mit ihrer Syntax und Parametererkl rung Sie sind in der Reihenfolge beschrieben wie sie von AVAS QUER erwartet werden Nach der Beschreibung folgt ein Beispiel SDF Standardanweisungen Die folgenden SDF Standardanweisungen d rfen w hrend des AVAS QUER Laufs einge geben werden Sie sind im Handbuch Einf hrung in die Dialogschnittstelle SDF 13 beschrieben SDF Standardanweisung Bedeutung END Beenden des Programms MODIFY SDF OPTIONS ndern der SDF Einstellungen REMARK Kommentieren von Programmen RESTORE SDF INPUT Wiederanzeigen der letzten Eingabe SHOW SDF OPTIONS Anzeigen der SDF Einstellungen STEP Definieren eines Wiederaufsetzpunktes WRITE TEXT Text nach SYSOUT ausgeben 240 U21462 J Z125 7 Dienstprogramm AVAS QUER Anweisungen von AVAS QUER SIGNON Anmelden an AVAS System ber die Anweisung SIGNON meldet sich der Benutzer an das AVAS System an Die Anweisung SIGNON muss am Beginn einer Verarbeitungsfolge stehen SIGNON AVAS USER ID avuser PASSWORD password AVAS SYSTEM ID string AVAS USER ID avuser Identifikation des AVAS Benutzers maximal 8 Zeichen PASSWORD password Kennwort des AVAS Benutzers maximal 8 Zeichen Im gef hrten Dialog wird das Kennwort dunkelgesteuert eingegeben
195. CAVSCCDNM CAVSCCDNT CAVSCCDNN CAVSCCDNI CAVSCNETN CAVSCRCSN CAVSCRSVT CAVSCERIN CAVSCERJN CAVSCAUID CAVSCAUPW CAVSCASID AVSCPERN AVSCNETN AME condname group Programmschnittstelle von AVAS ESCRIPTION AME MODIFY COND D CONDITION CONDITION TYPE VAL CONDITION VALUE RARY LIBRARY JRNDAT ET NAME netname group E period L SYSTEM avak RARY LIBRARY ABLDAT ET NAME netname group E period L SYSTEM avak ET STATUS status RARY LIBRARY ABLDAT READ AVAS LIB AVAS USER PERIOD NAM RUN CONTRO READ AVAS LIB AVAS USER PERIOD NAM RUN CONTRO READ AVAS LIB AVAS USER CONDITION CONDITION TYPE type NET netname INDEX index CREATED BY CREATED BY RESTART NET ET NAME ROL SYSTEM T VARIANT INDEX RUN CO RESTAR ERROR ERROR NAME Ds SIGNON AVAS USER PASSWORD AVAS SYSTEM ID SUBMIT NET LPERIOD NAME uda LNET NAME Die Felder die den Parametern einer Anweisung zugeordnet sind m ssen gel scht wer den wenn ein Parameter nicht verwendet werden soll Die Vorgabe des Parameters RUN CONTROL SYSTEM wird eliminiert wenn die geforder te Anweisung diesen Parameter nicht zul sst Bei einer nachfolgenden Anweisung die den Parameter RUN CONTROL SYSTEM verlangt wird der Standardwert angenommen wenn der Parameter nicht vorgegeben ist Entsprechendes gilt f r de
196. CNTAPP zj CNTAPC amp CNTAPC PARTFN SV 464 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs CALL PROCEDURE LIBRARY ELEMENT ELEMENT AVS TRANSFER 2 LIBRARY amp USERID SYSPRC AVAS 070 PROCEDURE PARAMETERS USERID amp USERID u CNTAPP amp CCNTAPP 3 CNTAPC amp CCNTAPC Z es SW29SET REMARK END PROCEDURE Hinweis Parameter die nicht mit INIT Klausel angegeben sind werden von der Ablaufsteuerung gesetzt Sie m ssen unver ndert an AVSSINCM bergeben werden wenn die Proze dur eigenen Bed rfnissen angepasst oder in eine andere Prozedur eingebettet wird AVSSINCM erwartet dass alle Parameter au er den Parametern zur Vorgabe von Standardwerten AVS DEF angegeben werden USERID Der Parameter ist mit Katalogkennung und oder Benutzerkennung zu beschreiben wenn die Ladebibliothek nicht dort vorhanden ist wo AVSSINCM abl uft Die Angabe muss mit einem Punkt enden CNTAPP Name der Applikation CENTRAL CNTAPC Name des Prozessors mit der Applikation CENTRAL AVS AVAK FILE Name der Datei in die die Ablaufsteuerung das Skript geschrieben hat oder Dateiname auf dem Server bei externen Jobs AVS AVAK NAME Name der Ablaufsteuerung AVS CONF FILE Name der Konfigurationsdatei AVS CONF PASSW Kennwort f r die Konfigurationsdatei Wenn kein Kennwort verwendet wird ist d
197. CTORY AVS DEF SERVER PATH 4 L P EI Ts T Der Name der Startprozedur f r AVSSINCM und deren Kennwort m ssen in der Start prozedur der Ablaufsteuerung eingetragen werden 5 Anpassen der Startprozedur f r die Ablaufsteuerung In der ausgelieferten Startprozedur der Ablaufsteuerung sind die Startparameter f r die Server Unterst tzung zu versorgen Name der Startprozedur f r AVSSINCM Parameter SERVER PROCEDURE NAME ggf ein Kennwort das zum Benutzen der Prozedur berechtigt Parameter SERVER PROCEDURE PASSW der Name der Konfigurationsdatei Parameter CONFIG FILE NAME ggf ein Kennwort das zum Lesen der Konfigurationsdatei berechtigt Parameter CONFIG FILE PASSWORD Die Angaben zur Konfigurationsdatei werden ben tigt wenn in der Netzbeschreibung eine Angabe f r SERVER NAME eingetragen ist U21462 J Z125 7 521 Einsatzvorbereitung AVAS SV Plattform bergreifende Jobsteuerung 6 Starten von AVSRECV im Server System AVSRECV ist auf jedem Rechner f r jede vergebene Portnummer einmal zu starten Wenn die vergebenen Nummern in etc services eingetragen wurden kann AVSRECV auch mit dem Service Namen gestartet werden Das beim Start von AVSRECV ange gebene Kommunikationskennwort Parameter comm pw muss mit dem entsprechen den Eintrag in der Konfigurationsdatei oder in der Startprozedur bereinstimmen Grop und Kleinschreibung beachten 7 Die notwendi
198. D Die Reorganisationsanweisung bergibt das AVAS Kennwort des mit AVAS USER ID angegebenen Benutzers USER PASSWORD C Quis Das Kennwort ist in der L nge von 8 Zeichen einzugeben Die Anweisung wird nur zusammen mit der Reorganisationsanweisung AVAS USER ID verarbeitet ZDD PASSWORD Die Reorganisationsanweisung bergibt das Kennwort f r die Anmeldung der Reorganisa tion bei der UPAM ZD Das Kennwort muss in der obligatorischen L nge von 4 Byte einge geben werden Die Anmeldung der Reorganisation bei der UPAM ZD gelingt nur wenn das Kennwort mit dem bereinstimmt das beim Start der UPAM ZD im Parameter REO PASSWORD ange geben wurde ZDD PASSWORD STD C X 0 STD Die Anmeldung bei der UPAM ZD erfolgt mit dem intern festgelegten Stan dardkennwort Cini Alphanumerische Eingabe des Kennworts 4 Zeichen Koran 1 Sedezimale Eingabe des Kennworts 8 Zeichen Wenn ZDD PASSWORD nicht angegeben wird wird STD angenommen 180 U21462 J Z125 7 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien ZDL PASSWORD Die Reorganisationsanweisung bergibt das Kennwort f r die Anmeldung der Reorganisa tion bei der PLAM ZD Das Kennwort muss in der obligatorischen L nge von 4 Byte einge geben werden Die Anmeldung der Reorganisation bei der PLAM ZD gelingt nur wenn das Kennwort mit dem bereinstimmt das beim Start der PLAM ZD im Parameter REO PASSWORD ange geben wurde
199. D cat id TSN tsn DATE jjjjmmtt JOBLOG NAME NONE dateiname EXTEND YES NO NEW INPUT FILE dateiname Die Bedeutung der Parameter und Parameterwerte ist der Beschreibung bei der Dialogfunktion unter der Maske AVIO19 zu entnehmen siehe Handbuch AVAS Anweisun gen 1 Der Parameter NET NAME muss angegeben werden der Parameterwert kann teilqualifi ziert angegeben werden Nur wenn der Parameter NET NAME mit einem vollqualifizierten Netznamen angegeben worden ist sind auch die weiteren Parameter zul ssig U21462 J Z125 7 313 ADD JOB LOG BATCH Anweisungen Nach einer BATCH Anweisung ADD JOB LOG k nnen keine weiteren AVAS BATCH An weisungen unterhalb eines BS2000 Kommandos START PROG verarbeitet werden weil die JOB LOG Dateien ber SYSDTA eingelesen werden und auf die Datei mit den AVAS BATCH Anweisungen noch nicht zur ckgeschaltet werden kann Sollen mehrere Protokolle ber AVAS BATCH Anweisungen eingelesen werden so ist AVAS BATCH mehrfach aufzurufen Beispiel BEGIN PROC REMARK 1 PROTOKOLL UEBERTRAGEN CALL PROC SYSPRC AVAS 070CAVS BATCH USERID lt userid gt CMDFILE AVAS BATCH 1 REMARK 2 PROTOKOLL UEBERTRAGEN CALL PROC SYSPRC AVAS 070CAVS BATCH USERIDe userid CMDFILE AVAS BATCH 2 On Sa Ra er END PROC Protokoll der Verarbeitung F r jedes bearbeitete Netz wird AVS8521 ADD JOB LOG netname RESULT ergebnis ausgegeben und ggf eine Fehl
200. D x AND FUNCTION C C DIC DICAM DICAMDIW IJPX P CIX COND INDEX CUN COND JOB NA i CNN COND NET NA ENT ENTER PARAMS FCN FULL COND N E xus EN FULL NAME VPOS VALUE POSIT VLEN VALUE LENGTH E VPAS JVA PASSWORD J2SYN DS CL3 SYNC INDEX J2ENT DS X ENTER PARAMS ENTER PARAMS J2EEPN EQU 33 ET J2EEPL EQU 157 LOGON J2DOC DS CL43 DOCUMENT NAME DS CL21 RESERVED J2TEX DS CL120 TITLE INFORMATION J2RSP DS 3CL34 RESTART POINT 1 3 J2RSE DS DC ORG NJ2RSP J2RSIN DS CL3 RESTART INDEX J2RSTY DS X RESTART TYPE RESTART TYPE J2ERNM EQU 72 NORMAL J2ERST EQU 73 RESTART J2ERSA EQU 78 RESTART AUTOMATIC J2ERNA EQU 79 NORMAL AUTOMATIC J2RSJN DS CL30 RESTART NAME J2E L EQU NJ2RSIN SEGM LENGTH ORG NJ2RSE J2E Z EQU NJ2RSP NJ2E L SEGM COUNTER DS CL2 RESERVED J2LMIN EQU NJ2A RECORD LENGTH MINIMUM J2VA DS CL74 VARIABLE AREA ORG NJ2VA J2FN DS CL57 FULL NAME ORG NJ2VA U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen D NAME OSITION ENGTH JVA PASSWORD B NAME D NET NAME DEX 363 LL CO LUE P LUE L D J0 D IN RVED FU VA VA CO CO CO RESE Externe Erstellung von AVAS E
201. DELETE JOB LOG k nnen alle Protokolle eines Netzes gel scht werden DELETE JOB LOG NET NAME bk netname Protokoll der Verarbeitung F r jedes gel schte Netz wird AVS8521 DELETE JOB LOG netname RESULT ergebnis ausgegeben und ggf eine Fehlermeldung DELETE NET DESCRIPTION L schen von Netzen Mit DELETE NET DESCRIPTION k nnen Netze in der AVAS Benutzerbibliothek NETLIB gel scht werden DELETE NET DESCRIPTION NET NAME bk netname Der Parameter NET NAME muss angegeben werden der Parameterwert kann teilqualifi ziert angegeben werden Protokoll der Verarbeitung F r jedes gel schte Netz wird AVS8521 DELETE NET DESCRIPTION netname RESULT ergebnis ausgegeben oder eine Fehlermeldung 330 U21462 J Z125 7 BATCH Anweisungen DELETE PERIOD DELETE PERIOD L schen einer Periode Mit DELETE PERIOD kann ein Eintrag mit dem angegebenen PERIOD NAME in der Peri odendatei gel scht werden Wenn der Parameter PERIOD NAME teilqualifiziert angegeben wird werden alle Perioden gel scht deren Namen der angegebenen Teilqualifizierung entsprechen Hinweis Perioden mit TYPE VAR Standard Perioden mit variablem Datum k nnen nur ber die BATCH Anweisung DELETE PERIOD gel scht werden DELETE PERIOD PERIOD NAME period Der Parameter PERIOD NAME muss angegeben werden Er kann vollqualifiziert oder teilqualifiziert letztes Zeichen angegeben werden Protokoll der Verarbeitung F r jede gel schte Periode
202. DER liste status SORT FIELDS ORDER liste felder SELECT STATUS liste status THRESHOLD 2 e delay l delay OUTPUT REPORT FILE full filename OUTPUT REPORT LINK full filename END Wenn unzul ssige oder fehlerhafte Anweisungen gefunden werden werden diese als unzul ssig protokolliert und die Verarbeitung der Eingaben wird abgebrochen Die Sortierfolge kann beim OUT OF PLAN Report ber die Anweisungen SORT STATE ORDER und SORT FIELDS ORDER festgelegt werden F r die Ausgabe in die Reportdatei k nnen Netze ber die REPORT Anweisungen SELECT STATUS und THRESHOLD ausgew hlt werden Unter NET SUMMARY werden auch die nicht ausgew hlten Netze aufgef hrt 304 U21462 J Z125 7 OUT OF PLAN Report AVAS Reports In der ber FUNKTION PRINT zu erzeugenden Liste werden die folgenden Daten der Net ze ausgewiesen GLOBAL STATE Bezeichnet den globalen Status der auf einer Seite aufgelisteten Netze Dabei wird der AVAS Status STATE der Netze zu den globalen Status werten zusammengefasst TOCREATE NOTTOCREATE PARTIALLY CREATED SUBMITTED WAITING OPWAIT START nach START NET HOLD vor START RESUMED vor START RUNNING CONDWAIT HOSTWAIT RESTARTED HOLD nach START RESUMED nach START ERROR ENDED IGNORED ABENDED entspricht entspricht entspricht entspricht entspricht entspricht NO SUBMIT WAIT
203. DOS Anweisungen beinhalten die eine Aktion des Anwenders erwarten dann f hrt z B die Anweisung pause zum Stillstand der Verarbeitung der Anwenderjob bleibt im Status RUNNING Erl uterungen zu Startart manuell Wenn der Anwender f r den Windows Dienst die Startart manuell einstellen m chte kann er bei einem erneuten Hochfahren des Windows Systems ber Systemsteuerung gt Diens te die Startart einstellen Dazu wird der Eintrag des Windows Dienstes gesucht und mar kiert ber Startart kann jetzt die Startart manuell eingestellt werden Der Start des Dienstes erfolgt dann ber Systemsteuerung gt Verwaltung gt Dienste Dazu wird der Eintrag des Windows Dienstes gesucht und markiert und ber Starten ohne wei tere Parameter gestartet Der erfolgreiche Start wird ber den Status gestartet angezeigt Bei Startart manuell muss bei jedem Start des Systems der Dienst erneut gestartet werden Beenden des Dienstes AvasService auf Windows Systemen Der Dienst wird automatisch beendet wenn das System heruntergefahren wird SHUTDOWN Davon abweichend kann der Dienst ber Systemsteuerung gt Verwaltung gt Dienste beendet werden Dazu wird der Eintrag des Windows Dienstes markiert und die Funktion Beenden ausgel st Nach der Durchf hrung ist der Status gestartet gel scht ber den Taskmanager wird der Dienst nicht mehr angezeigt Wenn der Dienst installiert und die Starta
204. DS CL30 RESTART 2 J0BNAME AVSNRSI3 DS 603 RESTART 3 1NDEX AVSNRST3 DS X RESTART 3 TYP AVSNRSJ3 DS CL30 RESTART 3 JOBNAME AVSNLTS DS OCLl4 LATEST START DATE 8 AND TIME 6 AVSNLTSD DS OCL LATEST START DATE YYYYMMDD AVSNLTSH DS CL2 LATEST START DATE YY AVSNLST DS 20202 LATEST START DATE 6 AND TIME 6 AVSNLSTD DS Cp LATEST START DATE YYMMDD AVSNLSTT DS Cp LATEST START TIME HHMMSS ORG AVSNLTS AVSNLTO DS 2202014 LATEST OCCURE DATE 8 AND TIME 6 AVSNLTOD DS OCL8 LATEST OCCURE DATE YYYYMMDD AVSNLTOH DS CL2 LATEST OCCURE DATE YY AVSNLOC DS 22012 LATEST OCCURE DATE 6 AND TIME 6 AVSNLOCD DS 06 LATEST OCCURE DATE YYMMDD AVSNLOCT DS Cp LATEST OCCURE TIME HHMMSS AVSNDSO DS X DELAY SOLUTION DS CU RESERVED AVSNLMIN EQU AVSNANET VARIABLE AREA ABOUT TYPE AND FUNCTION AVSNVANF DS CL320 FUNCTION C TYPE JVA ORG AVSNVANF AVSNFCN DS CL54 JVA NAME AVSNVPOS DS CL3 JVA POSITION AVSNVLEN DS CL3 JVA LENGTH AVSNCVAL DS CL256 JVA VALUE FUNCTION C TYPE NET ORG AVSNVANF AVSNCNOC DS 12XL1 OCCURE VALUE CODE KEYWORD AVSNCNEC DS 12XL1 ERROR VALUE CODE KEYWORD AVSNCNCN DS CL32 COND DESCR CREATED BY NET NAME FUNCTION C TYPE JOB ORG AVSNVANF AVSNCJOC DS 2XL1 OCCURE VALUE CODE KEYWORD AVSNCJEC DS 12XLl ERROR VALUE CODE KEYWORD AVSNCJCN DS CL32 COND DESCR CREATED BY NET NAME AVSNCOCI DS CL COND DESCR CREATED BY INDEX
205. Datenhaltung f r AVAS QUER Dienstprogramm AVAS QUER 5 3 4 Aufbau der Datenbanktabellen caltab Die Tabelle caltab enth lt die Zuordnung der Kalender zu Benutzerkreisen bkcal char 4 Benutzerkreisname calname char 20 Kalendername caldaysymtab Die Tabelle caldaysymtab enth lt die Zuordnung der Symdats zu Kalendertagen calname char 20 Kalendername datum char 8 Datum des Kalendertages JJJJMMTT symdat char 20 Name des symbolischen Datums Symdat weekday char 3 Name des Wochentages typ char 4 Typ des Kalendertages WORK NWRK FREE nettab Die Tabelle nettab enth lt die Zuordnung der PVS zu Netzen bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname pvs char 54 zugeordnetes PVS oder Jobvariablenname netdoktab Die Tabelle netdoktab enth lt die Zuordnung von Dokumenten zu Netzen bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname bkdok char 4 Benutzerkreis des Dokumentes dokname char 37 Dokumentname dokvorh char 1 Kennzeichen J N das anzeigt ob das Dokument in der DOCLIB vorhanden ist U21462 J Z125 7 248 Dienstprogramm AVAS QUER Datenhaltung f r AVAS QUER netsymtab Die Tabelle netsymtab enth lt die Zuordnung von Symdats zu Netzen bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname symdat char 20 Name des symbolischen Datums Symdat mit Relativ angaben nn 1 nn 99 starttime char 6 symbolischer Name der Startzeit lates
206. Dieser Wert ist anzugeben wenn der zentrale Zugriffsprozess ZDD ohne die Anweisung REOPW oder mit REOPW STD gestartet wird SYSTEM PASSWORD password Das Kennwort mit dem der zentrale Zugriffsprozess f r die Reorganisation gestartet wurde ist anzugeben s 4 Zeichen oder Xia i 8 Zeichen U21462 J Z125 7 300 REPORT Anweisungen THRESHOLD USER PASSWORD THRESHOLD Ausw hlen Netze gem ihrer Versp tung Mit THRESHOLD werden die Netze gem ihrer Versp tung ausgew hlt deren S tze in die Reportdatei ausgegeben werden sollen Netze bei denen die angegebene Versp tung noch nicht erreicht ist werden nicht in die Reportdatei ausgegeben Die auszugebende Menge kann ber die REPORT Anweisung SELECT STATUS weiter eingeschr nkt werden Die Anweisung wird nur beim OUT OF PLAN Report verarbeitet Die Anweisung muss nur bei FUNKTIONZPRINT angegeben werden THRESHOLD e delay l delay e delay Versp tung bez glich EARLIEST START 000 bis 999 Zeit in Minuten I delay Versp tung bez glich LATEST START 000 bis 999 Zeit in Minuten Es m ssen immer beide Werte angegeben werden Sollen alle Netze gem der durch SELECT STATUS definierten Liste ausgegeben wer den so ist anzugeben THRESHOLD 000 000 Wenn die Anweisung nicht angegeben wird wird intern gesetzt THRESHOLD 002 002 USER PASSWORD Angeben des Benutzerkennworts Jedem Benutzer ist ber die System Parameter ein Kennwort f r die An
207. E AVSRRCSN DS X RUN CONTROL SYSTEM AVSRPERN DS X PERIOD NAME AVSRSYDN DS X SYMDAT NAME AVSREAS DS X EARLIEST NEW PLAN START AVSRUSPF DS X USER PAR FILE AVSRERJN DS X ERROR JOBNAME AVSRERIN DS X ERROR INDEX AVSRRSVT DS X RESTART VARIANT AVSRUSLB DS X AVAS USER LIBRARY AVSRNSTI DS X ET STATUS AVSRCDNT DS X CONDITION TYPE AVSRCDNM DS X CONDITION NAME AVSRCDNN DS X CONDITION CREATED BY NET AVSRCDNI DS X CONDITION CREATED BY IND AVSRCDVL DS X CONDITION VALUE AVSRLTI DS X LIFE TIME DS Cl7 RESERVED COMMAND AREA AVSCAREA DS 0C AVSCMDC DS X AVAS CMD CODE AVSQSIGN EQU 11 SIGNON AVSQEND EQU 19 END U21462 J Z125 7 401 Assembler Schnittstelle Programmschnittstelle von AVAS AVSQRDAL EQU 51 READ AVAS LIBRARY AVSQCPLN EQU 61 CREATE PLAN NET AVSQCPRN EQU 68 CREATE PROD NET AVSOSUNE EQU 71 SUBMIT NET AVSQRENE EQU 77 RESTART NET AVSQMCDD EQU 88 MODIFY COND DESCRIPTION DS CL3 PARAMETER AREA 1 AVSCPARI DS 0CL92 AVSCAUID DS CL8 AVAS USER ID AVSCAUPW DS CL8 AVAS USER PASSWORD AVSCASID DS CL7 AVAS SYSTEM ID DS CL69 ORG AVSCPARI AVSCNETN DS CL32 NET NAME AVSCRCSN DS CL RUN CONTROL SYSTEM AVSCPERN DS CL37 PERIOD NAME DS CL15 PARAMETER AREA 2 AVSCPAR2 DS 20202066 AVSCSYDN DS CL20 SYMDAT NAME AVSCEAS DS CL19 EARLIEST START NEW PLAN START AVSCCALN DS CL20 CALENDAR NAME CL37 ORG AVSCPAR2 AVSCUSPF DS CL54 USER PAR FILE DS CL42 ORG AVSCP
208. E 3 OUTPUT SAVED AVSJNST4 DS X STATE 4 OUTPUT ERROR DS CL28 RESERVED DS 0C Erl uterung der Status Anzeigen NSTI X Status der Netzfreigabe SUBMIT NET X 00 LOW Das Netz wurde noch nicht freigegeben Den aktuellen Status zeigt NST2 X OE SUBMITTED Das Netz wurde freigegeben Den aktuellen Status zeigt NST2 X AE NETWAIT Das Netz wurde freigegeben und l uft als Subnetz unter der Kontrolle des Hypernetzes Den aktuellen Status zeigt NST2 X 19 WAITING Das Netz wurde als Subnetz freigegeben und l uft nicht unter der Kontrolle des Hypernetzes Den aktuellen Status zeigt NST2 X 3D OPWAIT Das Netz wurde als Subnetz freigegeben und l uft nicht unter der Kontrolle des Hypernetzes Den aktuellen Status zeigt NST2 NST2 X Aktueller Verarbeitungsstatus des Netzes in der Journaldatei Die Bedeutung der Schl sselw rter ist bei den Dialogfunktionen beschrie ben siehe Anweisungen SHOW PLAN NET SHOW NET STATUS usw 412 U21462 J Z125 7 Assembler Schnittstelle 413 TOCREATE PARTIALLY CREATED NOTTOCREATE SUBMITTED ABENDED ENDED ERR HOLD RUNNING WAITING Es oO a mm PLANNED LETED D D STWAIT Status der Journalsicherung QU et uu ee r Gzuz 1 07 d oO m m m mr LOW Die Journals tze wurden noch nicht gesichert SAVED Die Journals tze
209. ECUTED bei RESTART WAIT CONDITION YES im Restartfall auf Status WAITING umgesetzt und das Strukturelement nach dem Restart erneut ausge f hrt Definitionen f r die Funktionssteuerung DEFAULT CANCEL TYPE SOFT HARD SOFT F r die Funktion CANCEL NET wird der Parameter CANCEL TYPE SOFT voreingestellt wenn dieser nicht vorgegeben wird HARD F r die Funktion CANCEL NET wird der Parameter CANCEL TYPE HARD voreingestellt wenn dieser nicht vorgegeben wird Hinweis Der Wert gilt nicht f r CANCEL NET ber die Ablaufsteuerung Hier muss CANCEL TYPE HARD weiterhin angegeben werden 43 U21462 J Z125 7 Generierung des AVAS Systems Installation und Generierung 2 2 2 6 Symbolische Namen der AVAS Anweisungen und Variablen Beim Erzeugen ablauff higer Jobs in der JMDLIB JMDSYS k nnen die Steueranweisun gen noch modifiziert werden Hierzu bietet AVAS eigene Anweisungen bzw Variablen an Die vorgegebenen Standardwerte k nnen entsprechend umdefiniert werden Den symbolischen Namen der AVAS Anweisungen und Variablen f r die Modifikation der Jobs und JCL Bausteine und f r die Verarbeitung der Restart Anweisungen durch die Ablaufsteuerung sind standardm ig folgende Zeichenfolgen als AVAS Anweisungen und Variablen zugeordnet links symbolische Namen rechts zugeordnete Zeichenfolgen AVM AVM Job oder Netz Modifikation ber Benutzermasken AVS AVS Aufrufen eines JCL Bausteines AVD Aufrufen eines externen Ba
210. ER Aufruf abgegeben wird bergibt AVAS die Steuerung an die RZ Routine Die se erh lt alle Informationen um den BS2000 Job zu identifizieren und auf die ENTER Datei zugreifen zu k nnen Daten z B Kennw rter k nnen dadurch unmittelbar vor dem Start eines BS2000 Jobs modifiziert werden Die Kennw rter bergibt AVAS unverschl sselt Zudem ist es m glich die Verarbeitung eines BS2000 Jobs zu verhin dern Der Start eines BS2000 Jobs durch die Ablaufsteuerung kann kontrolliert zugelassen oder zur ckgewiesen werden U21462 J Z125 7 69 RZ Exits im AVAS System Installation und Generierung Die JCL des BS2000 Jobs in der tempor ren ENTER Datei kann kontrolliert und ver ndert werden Die Information JOB START kann an andere Programmsysteme oder Arbeitsgebiete weitergegeben werden Der Ausgang AVEX0401 wird aktiviert wenn die JCL eines BS2000 Jobs von der Ablaufsteuerung aus der Ablaufdatei in die tempor re ENTER Datei vollst ndig und fehlerfrei ausgegeben wurde e Server Job Nach der Ausgabe eines Server Jobs in eine tempor re Datei und bevor der AVAS Agent AVSSINCM gestartet wird bergibt AVAS die Steuerung an die RZ Routine Diese erh lt alle Informationen um den Server Job zu identifizieren und auf die Datei zugreifen zu k nnen Daten z B Kennw rter k nnen dadurch unmittelbar vor dem Start eines Server Jobs modifiziert werden Die Kennw rter bergibt AVAS unver schl sselt Zudem ist es m glich di
211. ERROR COM e Belegung und Inhalt der Server Jobvariable ist im Abschnitt Prozess Server berwa chung auf Seite 486 beschrieben AVSSINCM bertr gt den Zustand des Server Jobs in den Server Bereich seiner ablauf berwachenden Auftrags Jobvariablen Bei Ende des Server Jobs werden vom Server die LOG Dateien an AVSSINCM bertra gen wenn im Server Job eine bertragung signalisiert wurde Diese werden unter dem Namen AVSSVLOG lt avas jobid gt tsn STDERR STDOUT in der Benutzerkennung des AVSSINCM hinterlegt sie k nnen mit SIGNAL und TRANSFER in die LOGSYS bertragen werden Anschlie end bernimmt AVSSINCM die Server Information schreibt sie in seine ablauf berwachende Auftrags Jobvariable und setzt den SV Status gem Abschluss des Server Jobs auf T bei fehlerlosem Ablauf oder auf A wenn Fehler aufgetreten sind Da nach sendet AVSSINCM eine END Nachricht zu AVSSTRT und beendet sich je nach SV Status normal T oder abnormal A Wenn AVSSINCM w hrend der Arbeit die Verbindung zum AVAS Server AVSSTRT verliert setzt er den SV Status auf E und l sst den Zusatzstatus unver ndert Dadurch bleibt er kennbar dass die Verbindung verloren und das Ergebnis des Server Jobs noch nicht an die Ablaufsteuerung bermittelt wurde Anschlie end beendet sich AVSSINCM mit Exit Code Der Arbeitsfortgang und die Ergebnisse des Server Jobs werden durch Status und Zusatz status dargestellt U21462 J Z125 7 457
212. ERT FORMAT Linkname AVSQUER LOAD FORMAT 233 Name der Tabelle Linkname caltab AVSCAL caldaysymtab AVSCDAY nettab AVSNET netdoktab AVSNETD netsymtab AVSNETS nettexttab AVSNETT ordertab AVSORD orderdoktab AVSORDD ordersymtab AVSORDS ordersturntab AVSORDT ordertexttab AVSORDX U21462 J Z125 7 Arbeiten mit AVAS QUER Dienstprogramm AVAS QUER 5 1 2 Starten von AVAS QUER Die Funktion AVAS QUER kann auf zwei Arten aktiviert werden e ber die Prozedur AVS QUER CALL PROCEDURE LIB AVASS SYSPRC AVAS 070 ELE AVS QUER e ber das Programm AVAS SYS LOAD QUER START PROGRAM FROM FILE PHASE CLIBRARY SYSPRG AVAS 070 SYSTEM ELEMENT AVAS SYS LOAD QUER Wenn AVAS QUER ber die Prozedur aufgerufen wird werden die Linknamen automatisch zugewiesen Aufbau der Prozedur BEGIN PROC LOG N PAR YESCPROC PAR amp SYSVER 070 amp EXEC START amp SYSCMD PRIMARY amp SPPR 258 amp SPSE 129 amp SYSLNK SYSLNK AVAS amp AVUSERID amp FORMAT amp AUSGABE ACAL amp CDAYSYM amp NET amp NETDOK amp NETSYM amp NETTXT2 amp ORDER amp ORDERDOK amp ORDERSYM amp ORDERTUR amp ORDERTXT2 amp SYS amp SYSPAR ESC CHAR C amp EMARK AUSGABEFORMAT LOAD INSERT amp FORMAT 1 IP COM TO LABEL FA amp FORMAT FAINSERT REMARK FAI REMAR m 21m 11m Vo Mee D
213. FIX N 0 MACID N3 0 DMACID N3D C SUPPORT C D DS Op AHHHHE PREFIX N MACID N3 HHH DS Op DS H PLAM RECORD LENGTH DS PLAM RESERVED PLAM SK DS C PLAM RESERVED PLAM SA DS DES RECORD KEY DS 01 RESERVED DS CH RESERVED DS SL RESERVED DS SL ET INDEX 000 DS CL18 ET NAME DS CL14 RESERVED PLAN DESCRIPTION DS CL4 RESERVED EQU NN3A RECORD LENGTH MINIMUM DS 44Cl42 PLAN START DS oC ORG NN3PSSY DS 0CL20 SYMDAT NAME lt NAME NN gt DS REAL START DATE IDENTIFICAT DS 06 REAL START DATE lt YYMMDD gt DS 004 ZYKLUS OF REAL START DATE lt DN NN gt DS 09 RESERVED DS CL6 SYMDAT START TIME lt HHMMSS gt DS CL7 SYMDAT LATEST START lt DDDHHMM gt DS GEZ LIFE TIME lt DDDHHMM gt DS X NET DELAY SOLUTIO U21462 J Z125 7 NET STR MEANING CANCEL ox WAIT START IGNORE USED NOT USED RESERVED DELAY SOLUTION EQU 65 EQU 67 EQU 68 EQU 69 gos DS C NN3A NN3SLEN NN3SSL NN3IND NN3NAM 3LMIN 3PSSY 3PSSE 3SYMD 3RLDI 3RLDA 3ZYK 3STIM 3LAST 3LTIM 3NDSL 3EDSC 3EDSW 3EDSS 3EDSI 354 Externe programmtechnische Erstellung von Netzen 355 ER NN3SYMD SEGM LENGT NN3PSSE NN3PSSY NNSCE L SEGM COUNT OF NN3A EQU ORG EQU DS EQU Externe Erstellung von AVAS Elementen NNSCE L NNSCE
214. FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED JRNDAT NET JOURNAL DESCRIPTION 07 AVSPUNET LO FILLER PICTURE X 4 LO AVSPDATE PICTURE X 06 LO AVSPTIME PICTURE X 06 10 AVSPNUMS PICTURE X 02 0 AVSPACMD PICTURE X 0 AVSPAKT PICTURE X O AVSPUSER PICTURE X 08 0 AVSPINDX PICTURE X 03 0 AVSPFUNC PICTURE X 0 AVSPNAME PICTURE X 32 10 AVSPRECA 15 AVSPRSSL PICTURE X 02 15 AVSPRFNR PICTURE X 02 15 AVSPOUTD PICTURE X 316 FOR OUTPUT DATA PLEASE DEFINE YOUR OWN DEFINITION WITH 15 FILLER REDEFINES AVSPOUTD 17 FIELD PICTURE zen END OF COPY ELEMENT AVSCOBJN x 436 U21462 J Z125 7 Programmschnittstelle von AVAS Cobol Schnittstelle AVSCOBRT Ergebnisbereich definieren Das COPY Element AVSCOBRT definiert den Ergebnisbereich f r die Funktionen CREATE PLAN NET CREATE PROD NET MODIFY COND DESCRIPTION SUBMIT NET und RESTART NET Aufruf COPY AVSCOBRT Aufl sung des COPY Elements AVSCOBRT COPY AVSCOBRT AVSCOBRT 002 941006 47100678 AVAS U
215. H DS C DS C DS CL2 DS GET DS CL1 DS CL1 DS CL3 DS CL18 DS CL14 LIST OF MAPS EQU NN5A DS 32CL50 DS OF ORG NN5NFML DS CL8 DS CL2 DS CL40 EQU NN5NFNM ORG NN5NFME EQU DS OF EQU NN5A NN5A NN5SLEN NN5SSL NN5IND NN5NAM 5LMIN 5NFML 5NFME 5NFNM 5NFST 5NFTX SCES L 5CE Z 5L 358 Externe Erstellung von AVAS Elementen Externe programmtechnische Erstellung von Netzen AVASNET RECORD ZJI PREFIX N EQUZYES MFCHK MF C C PREFIX N 0 MACID J1 0 DMACID J1D 0 SUPPORT C D DS Op AHHHHE PREFIX N MACID J1 Hier J1A DS Op JISLEN DS H PLAM RECORD LENGTH De PLAM RESERVED PLAM SK D CG PLAM RESERVED PLAM SA 1550 DS 602 RECORD KEY JIFUNC DS DESCRIPTION FUNCTION CODE FUNCTION JIEFUA EQU CA ADD JIEFUC EQU C C COMPARE JIEFUD EQU C D J DELET JIEFUJ EQU CA START JOB JIEFUM EQU CH MODIFY J1EF EQU C N NET JIEFUP EQU ctp START PROCEDURE JIERUS EQU C S START J1EF EQU C w WAIT JIEFUX EQU C X START SERVER JOB DEE DS X DESCRIPTION TYPE CODE TYPE JIENET EQU 33 NET JlEJVA EQU 60 JVA JIEEXT EQU 70 EXT JIEMOD EQU 71 MOD JIEEXX EQU 81 EXX JIESTD EQU 94 0 J1EJOB EQU 112 JOB JIERES EQU 113 RES JIEVAL EQU 114 VAL 1511 EQU 115 TI DS 01 RESERVED 1108 DS CL3 INDEX JINAM DS 0130 NAME DS 02 RESERVED U
216. HELP und END ist die Voreinstellung 1 siehe auch Handbuch AVAS Anweisungen 1 funktion Name einer g ltigen Anweisung 0 1 Art der Berechtigung 0 keine Berechtigung f r die Anweisung 1 Berechtigung des Normal Benutzers sie ist auf die Elemente des zuge ordneten Benutzerkreises beschr nkt Berechtigung des privilegierten Benutzers er kann auf Elemente eines fremden Benutzerkreises innerhalb der eigenen Bibliothek zugreifen Die Definitionen f r die Funktionsberechtigungen k nnen im laufenden AVAS Betrieb ge ndert werden Die Anzahl der Funktionsberechtigungen ist nicht begrenzt Wenn die Funktion CREATE GENPAR verwendet wird darf eine Anweisung FUTABnnn nicht ber mehrere Zeilen definiert werden U21462 J Z125 7 33 Generierung des AVAS Systems Installation und Generierung 2 2 2 3 Definitionen der Systemvariablen der Benutzer AVAS Variable vom Typ S nnn kann der Benutzer mit Standardwerten definieren Beim Erzeugen ablauff higer Jobs in der JMDLIB JMDSYS durch die Anweisungen CREATE PROD JOB und CREATE PROD NET werden die vom Benutzer definierten Systemvariab len und die ihnen zugewiesenen Werte ber cksichtigt Die Systemvariablen m ssen mit dem Schl sselwort USVAR definiert werden USVAR nnn wert nnn 3 stellige Zahl zwischen 201 und 999 siehe Hinweis Die angegebene Zahl ergibt mit dem bei der Generierung vorge gebenen symbolischen Namen Standardzeichenfolge ist S den Namen der Systemvaria
217. IGEBEN VON DATEIKETTUNGSNAMEN EXPORT FILE FILE NAME DATEIX REMOVE FILE LINK LINK NAME IN REMOVE FILE LINK LINK NAME OUT REMAR AKTUALISIEREN VON DATEIX IN EINEM SORTIERLAUF REMAR AUSGABE VON DATEIX AUF EIN NEUES BAND SET FILE LINK LINK NAME SORTINO1 FILE NAME DATEIY SET FILE LINK LINK NAME SORTINO2 FILE NAME DATEIZ CREATE FILE FILE NAME DATEIX SUPPORT TAPE VOLUME SCR DEVICE TYPE T6250 SET FILE LINK LINK NAME SORTOUT FILE NAME DATEIX START PROGRAM FROM FILE SORT REMARK LOESCHEN KATALOGEINTRAG VON DATEIX EXPORT FILE FILE NAME DATEIX LOGOFF Wenn dieser Lauf wiederholt werden muss weil die mit Hilfe des Sortierlaufs erstellte Band ausgabedatei nicht korrekt ist z B wurde mit SORTINO2 eine falsche Datei zugewiesen dann ist Folgendes zu beachten Beim REPEAT NET w rde MARENAV in die JCL statt der Variablen VOL die VSN des zu der letzten Version von DATEIX im MAREN Katalog vermerkten Bandes eintragen Dies bedeutet die im letzten fehlerhaften Lauf erstellte SORT Ausgabedatei w rde weiterverar beitet und nicht die noch korrekte aus dem vorletzten Lauf hier mit LINK IN zugewiesen Um dies zu verhindern muss die letzte fehlerhafte Dateiversion aus dem MAREN Katalog entfernt werden Dies kann auf mehrere Arten geschehen Die einfachste M glichkeit besteht darin im Archiveintrag des zuletzt erstellten Ausgabebandes den Dateinamen DATEIX mit der MAREN Anweisung MOD VOL ATT
218. ING STARTED ERROR ENDED ABENDED Die aufgef hrten Werte von GLOBAL STATE sind auch die zul ssigen Angaben bei den REPORT Anweisungen SORT STATE ORDER und SELECT STATUS Der vollstandige Netzname mit den Erweiterungen Datum und Uhrzeit wie er bei der AVAS Funktion CREATE PLAN NET gebildet wurde Der aktuelle AVAS Status des Netzes zum Zeitpunkt der Reporterstellung 305 NET NAME STATE U21462 J Z125 7 AVAS Reports OUT OF PLAN Report L E DELAY Die Versp tung der Netze bez glich LATEST START und EARLIEST START Die Versp tung L DELAY bez glich LATEST START wird nur durch einen Stern ausgewiesen wenn der Zeitpunkt LATEST START berschritten wurde Die Versp tung E DELAY bez glich LATEST START wird durch eine Zeit angabe in Stunden und Minuten ausgewiesen in der Form hhhh mm REAL START Startzeit des Netzes in der Form ttmmjj hh mm Der Wert wird nur ausgewiesen wenn das Netz gestartet wurde Wenn bei Netzen im Status ENDED oder ABENDED kein Datum angegeben ist wur de das Netz wegen NET DELAY SOLUTION IGNORE bzw NET DELAY SOLUTION CANCEL oder mit CANCEL NET in den Status gebracht REAL END Beendigungszeit des Netzes in der Form ttmmjj hh mm Der Wert wird nur ausgewiesen wenn das Netz bereits das normale Ende erreicht hat EARLIEST Der aktuelle Wert beim Netz f r EARLIEST START in der Form ttmmjj hh mm Wenn der Wert von EARLIEST START nach der Planung des Netzes gean dert wurde ist
219. ING STARTED THRESHOLD 5 2 OUTPUT REPORT FILE AVAS REPORT OOP END ASSIGN SYSDTA TO FILE PRIMARY ENDE END PROC U21462 J Z125 7 285 REPORT Generator AVAS Reports Beispiel f r die Eingabe der Anweisungen ber eine Datei BEGIN PROC LOGG COM PAR YESCPROC PAR amp REPORT ESC CHAR C amp ASSIGN SYSDTA TO FILE AVAS PAR amp REPORT START PROG FROM FILE PHASE CLIB AVAS SYSPRG AVAS 070 SYSTEM ELEMENT AVAS SYS LOAD REPORT ASSIGN SYSDTA TO FILE PRIMARY ENDE END PROC 7 1 2 Ausw hlen der Funktionen des REPORT Generators Mit der REPORT Anweisung FUNKTION w hlt der Benutzer die Funktionen des REPORT Generators aus und bringt sie zum Ablauf 7 1 3 Zuordnung des Produktionsplans und der Journaldatei Mit den REPORT Anweisungen AVAS SYSTEM ID und AVAS USER ID w hlt der Benutzer einen bestimmten Produktionsplan NPRLIB aus der dem REPORT Generator zugeord net wird Diese beiden Anweisungen m ssen nur bei FUNKTION CREATE angegeben werden Damit auf den so ausgew hlten Produktionsplan zugegriffen werden kann m ssen die zugeordneten Kennw rter ber die REPORT Anweisungen USER PASSWORD und SYSTEM PASSWORD angegeben werden Mit der REPORT Anweisung AVAS SYSTEM ID w hlt der Benutzer eine bestimmte Jour naldatei aus Diese Anweisung muss nur bei FUNKTION CREATE angegeben werden Damit auf die so ausgew hlte Journaldatei zugegriffen werden kann muss das zug
220. INSERT FORMAT Die SQL Anweisungen k nnen z B mit INFORMIX isgl Men SQL Dialog Men punkte Datei Laden und START zur Ausf hrung gebracht werden LOAD1 FORMAT Die Daten k nnen mit der SQL Anweisung LOAD mit INFORMIX isgl Men SQL Dialog Neu und der Anweisung LOAD FROM dateiname INSERT INTO tabellenname in die Datenbank eingebracht werden 246 U21462 J Z125 7 Dienstprogramm AVAS QUER Datenhaltung f r AVAS QUER Einbringen der Daten in andere Datenbanken Dies betrifft die Ausgabedateien die im LOAD2 FORMAT erstellt wurden Abh ngig vom verwendeten Datenbanksystem sind eventuell vorher die Datenbanktabel len zu definieren Die Daten werden in die Datenbank durch die datenbankspezifischen Anweisungen eingebracht Die von AVAS QUER erstellten Ausgabedateien m ssen vom Benutzer modifiziert werden wenn sein Datenbanksystem ein anderes Format unterst tzt 5 3 3 Struktur der Datenbank Bild 4 zeigt die Struktur der Datenbank mit ihren Tabellen Die AVAS Objekte und ihre Beziehungen Querverweis sind in diesen Tabellen hinterlegt Die Strukturelemente eines Netzes hei en order Benutzerkreis caltab er an nettexttab Text Netz Kalender nettab ee e caldaysymtab Kalendertag Symdat Dokumen ordersymtab ordersturntab Tabellen in der Datenbank Tabellenname detur y PN SELECT TURNUS Bild 4 Struktur der Datenbank im Zielsystem U21462 J Z125 7 247
221. ION Prozedur zum Bearbeiten der optionalen REP Korrekturen Die optionalen REP Korrekturen der AVAS Biblotheken SYSLNK AVAS 070 SYSPRG AVAS 070 SYSTEM und SYSPRG AVAS 070 DIALOG k nnen mit der Prozedur SYSPRC AVAS 070 SCANOPTREPS aus der Bibliothek SYSPRC AVAS 070 angezeigt aktiviert und deaktiviert werden 126 U21462 J Z125 7 Administration von AVAS Bedienen und berwachen der AVAS Prozesse 3 2 Bedienen und berwachen der AVAS Prozesse 3 2 1 Bedienen der Zugriffsprozesse Die Zugriffsprozesse werden ber Eingaben in Jobvariablen durch die sie kontrolliert wer den verwaltet Die Namen der Jobvariablen sind in den System Parametern festgelegt Bei den Eingaben in Jobvariablen ist zu unterscheiden zwischen e Eingaben zur Verwaltung der angemeldeten Benutzer e Eingaben zur Beendigung der Zugriffsprozesse und e der Eingabe zum Einmischen der Notjournaldatei Alle Eingaben erfolgen ber MODIFY JV JV IDENT JV NAME C jvname VALUE C operation ab der ersten Stelle der berwachenden Jobvariablen Operationen zur Verwaltung der angemeldeten Benutzer CANCEL SOFT Mit der Eingabe von CANCEL SOFT werden alle angemeldeten Dialog Batch und PSS Benutzer abgemeldet sobald sie die laufende Anweisung beendet haben Die betreffende ZD wird f r Neuanmeldungen gesperrt PSS Programmschnittstelle CANCEL HARD Mit der Eingabe von CANCEL HARD werden alle angemeldeten Dialog Batch und PSS Benutzer abgemeldet sobald der ak
222. IX N MACID N2 NN2A DS Op NN2SLEN DS H PLAM RECORD LENGTH DS PLAM RESERVED PLAM SK DS C PLAM RESERVED PLAM SA NN2SSL DS CL RECORD KEY DS 01 RESERVED DS CH RESERVED DS SL RESERVED NN2IND DS CL ET INDEX 000 NN2NAM DS CLI8 ET NAME DS cL14 RESERVED PLAN DESCRIPTION DS 004 RESERVED 2LMIN EQU NN2A RECORD LENGTH MINIMUM 2PSSY DS 44Cl42 PLAN START 2PSSE DS DC ORG NN2PSSY 2SYMD DS 0CL20 SYMDAT NAME lt NAME NN gt 2RLDI DS C REAL START DATE IDENTIFICAT 2RLDA DS 06 REAL START DATE lt YYMMDD gt DS 0013 RESERVED 2STIM DS CL6 SYMDAT START TIME HHMMSS 2LAST DS 607 SYMDAT LATEST START lt DDDHHMM gt 2LTIM DS CL LIFE TIME lt DDDHHMM gt 2NDSL DS X ET DELAY SOLUTIO x DELAY SOLUTION ET STR gt MEANING 2EDSC EQU 65 CANCEL 2EDSW EQU 67 WAIT 2EDSS EQU 68 START 25051 EQU 69 IGNORE 9 USED 9 NOT USED 352 U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen 353 H ER C RESERVED NN2SYMD SEGM LENGI NN2PSSE NN2PSSY NN2CE L SEGM COUN OF NN2A DS EQU ORG EQU DS EQU Externe Erstellung von AVAS Elementen NN2CES L NN2CE Z NN2L U21462 J Z125 7 Externe Erstellung von AVAS Elementen Externe programmtechnische Erstellung von Netzen AVASNET RECORD N3 PREFIX N EQU YES MFCHK MF C C PRE
223. J 3 0 99 COE EC 5 5 5 2 E E gt e m HOLD JOB CMD EQU YES ESUME NET ESTART NET TART NET EPEAT NET AKTION TOCREATE PARTIALLY CREATED OTTOCREATE SUBMITTED R R MODIFY SUBMIT 5 R DED ED D ING TING DWAIT END ERR HOL RU AI AB C0 zB C m C m rm rm TE RT A oO U21462 J Z125 7 PLANNE DELETE RESTA RESUM RESUM IGNOR CANCE EXECU START RESTA 0 Datenstrukturen Journalsicherung Not Journaldatei DS CL6 UHRZEIT DS XL2 LAUFENDE NUMM DS X AVAS FUNKTION AVASEQU N3 VERSION 070 EQU 04 EQU 57 EQU 61 EQU 62 EQU 63 EQU 66 EQU 68 EQU 69 EQU 70 EQU 71 EQU 72 EQU 73 EQU 75 EQU 76 EQU 77 EQU 78 EQU 79 EQU 80 DS X AUSGEFUEHRTE AVASEQU N3 VERSION 070 EQU 9 EQU 10 EQU 1 EQU 12 EQU 14 EQU 20 EQU EN EQU 22 EQU 23 EQU 24 EQU 25 EQU 26 EQU 27 EQU 28 EQU 29 EQU 63 EQU 65 EQU 66 EQU 68 EQU 73 EQU 123 EQU 124 EQU 125 Les 2 N FUNK TT m mm rr mm T DT TT TT Mm m TTI Mm TTI C29 CO CO CO CO CO CO CO CO CO C2 CO CO CO CO CO C20 CO CC WW CO EEXD ESTR ERST EPLD C29 GA CO CO CO CO CO CO CO CO CO CO CO CO CO CO CO OO CO CO 1 1 T 198 Sicherung und Reorganisation Datenstrukturen Journalsicherung Not J
224. Job Server Job oder jede gel schte S Prozedur wird AVS8521 DELETE PROD JOB elementname RESULT ergebnis ausgegeben oder eine Fehlermeldung END Beenden der Folge der BATCH Anweisungen END schlie t eine Verarbeitungsfolge ab END Protokoll der Verarbeitung AVS2310 SYSTEM BEENDET U21462 J Z125 7 333 BATCH Anweisungen HOLD NET Anhalten von im Ablauf befindlichen Netzen Mit HOLD NET kann die Verarbeitung von Netzen unterbrochen werden Der erforderliche Netzstatus vor der Ausf hrung der Anweisung ist RUNNING CONDWAIT HOSTWAIT WAITING OPWAIT RESTARTED ERROR oder START Wenn sich das Netz im Status RUNNING befindet wird nach Ausf hrung der Anweisung das Netz generell auf Status CALLED FOR HOLD gesetzt Wenn sich das Netz im Status CONDWAIT HOSTWAIT WAITING OPWAIT RESTARTED ERROR oder START befindet wird nach Ausf hrung der Anweisung der Status des Netzes in Abh ngigkeit von der Verarbeitungsart gesetzt In allen anderen F llen wird der Status des Netzes auf HOLD gesetzt Der Netzstatus CALLED FOR HOLD wird von der Ablaufsteuerung auf Status HOLD umgesetzt wenn sie die Indexstufe f r die die Unterbrechung gefordert wurde erreicht hat und kein weiterer Auftrag mehr abl uft Im Journal wird die Ausf hrung der Anweisung protokolliert HOLD NET NET NAME S bk netname RUN CONTROL SYSTEM avak INDEX index PERIOD NAME period date time date time Der Parameter NE
225. Jobs Das Trennzeichen wird bei Server Jobs dazu verwendet um den Jobbereich von der Parameterbeschreibung zu trennen Die Zeichenfolge wird bei Server Jobs in der JCLLIB JCLSYS JMDLIB JMDSYS und ABLDAT generell als letzter Satz abgelegt auch wenn ohne Parameter gearbeitet wird Hinweis Die Zeichenfolge muss auch bei COPY ELEMENT mit MODE LIBIN SAMIN und AVAS USER LIBRARY JCLLIB beim Kopieren von Server Jobs verwendet wer den Sonst werden die kopierten Elemente als Jobs im Inhaltsverzeichnis der JCLLIB eingetragen Die Zeichenfolge ist f r AVAS reserviert und darf in den Server Jobs nicht in einem anderen Zusammenhang verwendet werden Die Zeichenfolge darf nicht mit dem Wert DEFAULT PROCPAR STRING identisch sein PARAM JOURNAL OUTPUTS STD LIST ALL NO Der Generierungs Parameter steuert das Protokollieren der Ersetzung von AVAS Vari ablen im Journal bei der Anweisung CREATE PROD NET STD Die Journals tze 25 01 und 25 02 werden f r jeden modifizierten Satz aus gegeben Der Name der USER PARAM FILE wird mit dem Satzschl ssel 21 01 aus gegeben U21462 J Z125 7 41 Generierung des AVAS Systems Installation und Generierung LIST Beim Start der Modifikation eines Netzes ber die Anweisung CREATE PROD NET wird eine Liste aller Parameter aus der USER PARAM FILE mit dem Satzschl ssel 21 01 ausgegeben Aufbau SSL 21 01 filename parametersatz Zus tzlich werden die Werte der Systemvariablen S 001 S 002 und
226. K FILE NAME amp USERID SYSLNK AVAS 070 SET FILE LI LINK NAME SORTIN FILE NAME AVAS WORK REPORT amp REPORT SET FILE LI LINK NAME SORTOUT FILE NAME AVAS WORK REPORT amp REPORT ASSIGN SYSDTA TO FILE SYSCMD START PROG FROM FILE PHASECLIB amp USERID SYSPRG AVAS 070 SYSTEM ELEMENT AVAS SYS LOAD REPORT U21462 J Z125 7 309 Prozeduren und Bibliotheken f r die AVAS Reports AVAS Reports REPORT NAME OUT OF PLAN FUNKTIO ALL AVAS SYSTEM ID AAVSYID SYSTEM PASSWORD RAVSYPW AVAS USER ID AAVSUSID USER PASSWORD R amp AVUSPW NET NAME ALL OUTPUT WORK FILE AVAS WORK REPORT amp REPORT SORT STATE ORDER ERROR NO SUBMIT WAITING STARTED ENDED ABENDED SORT FIELDS ORDER STATE NET NAME E DELAY SELECT STATUS ERROR NO SUBMIT WAITING STARTED THRESHOLD 51 2 OUTPUT REPORT FILE AVAS FILE REPORT amp REPORT END ASSIGN SYSDTA TO FILE PRIMARY SHOW FILE ATTR FILE NAME AVAS FILE REPORT amp REPORT WRITE TEXT TEXT2 FILE AVAS FILE REPORT amp REPORT ERSTELLT SKIP COM REP END SET JOB STEP SKIP COM ABEND REPSPNM REMAR gt PNM REPORT ZSET FILE LI LINK NAME SYSLNK FILE NAME amp USERID SYSLNK AVAS 070 SET FILE LI LINK NAME SORTIN FILE NAME AVAS WORK REPORT amp REPORT TZSETSELEE L T LINK NAME SORTOUT FILE NAME AVAS WORK REPORT amp REPORT ASSIGN SYSDTA
227. K AREA WRK AREA AVSWAREA DS 06 AVSWMGCT DC H O COUNTER MAX MESSAGE TAB AVSWMGCR DS H RETURN MESSAGE TAB COUNTER AVSWFILE DS CL54 FILENAME MESSAGE OUTPUT FILE DS CL22 RESERVED AVSWMTAB DS 0CL136 AVSW QWL EQU AVSWAREA LNG WORK AREA ORG AVSWMTAB io MSG TAB AVSWMPAR DS 0CL136 DS H RESERVED DS X RESERVED AVSWMSGS DS C CONTINUATION LINE AVSWONTL EQU C NEXT LINE AVAS MESSAGE AVSWMSG DS 0CL7 AVAS MESSAGE AVSWMSGK DS CL3 KEY AVSWMSGN DS CLA NUMBER AVSWMSGT DS CL125 AVAS MESSAGE TEXT 406 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Schnittstelle AVSASSCD Verzeichniseintrag Bedingungseintr ge in Ablaufdatei definieren Makro Parameter AVSASSCD MF C D PREFIX A char 1 gt MACID VSI char 3 gt EQU NO YES Parameter MF und PREFIX siehe AVSASSAD auf Seite 389 MACID Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Standardwert VSI EQU Steuert die Generierung von Equates f r die Schl sselfelder NO Es werden keine Equates generiert YES Es werden Equates generiert Hinweis Der Makro AVSASSCD generiert eine Verl ngerung des Ausgabebereichs Er muss daher im Anschluss an den Makro AVSASSBO aufgerufen werden U21462 J Z125 7 407 Assembler Schnittstelle Programmschnittstelle von AVAS A
228. L WAIT TIME ERRORS HOIMWTE DS CL9 MAX WAIT TIME ERRORS HOIDAZE DS CL6 MITTLERE ANZAHL ERRORS HOIDAZE DS CL6 MITTLERE ANZAHL ERRORS DS CL250 RESERVIERT HOLARWTDSOC ADR RUN WAIT TIMES DS 64CL55 RUN WAIT TIME 1 64 HOIERWT DS 0C END RUN WAIT TIMES HOISLEN EQU H01H01 LAENGE SATZ 1 ORG HOlARWT HOIPST1 DS CL14 PLAN START HOIRTNI DS CL9 RUN TIME NET HOIRTJl1 DS CL9 RUN TIME JOBS HOIWTCI DS CL9 WAIT TIME COND HOIWTEl DS CL9 WAIT TIME ERROR HOIAZEl1 DS CL3 ANZAHL ERROR DS CL2 RESERVED ORG HOIERWT U21462 J Z125 7 223 Sicherung und Reorganisation Definitionen KEY 02 TYP SUM FU J P X H02 AVASJRN 2 SATZBESCHREIBUNG HISTORY KEY 02 AB VERS 6 0 H02 002802 DS op SATZBESCHR HISTORY KEY 02 HO2SLEN DS H SATZLAENGENFELD
229. LIB Die Kennw rter k nnen verschl sselt gespeichert werden Die Verschl sselung erfolgt bei CREATE PLAN NET Die Verschl sselung erfolgt ber die ZDL ABLDAT Die verschl sselten Kennw rter aus der NPRLIB werden in die ABLDAT bernommen Bei der Eingabe ber MODIFY SUBMIT NET werden die Kennw rter ver schl sselt Das alte Kennwort wird nicht gepr ft Hinweise e Das in den Netzen gespeicherte Kennwort SERVER PASSWORD wird nicht verschl s selt e Wenn der geheime Schl ssel ge ndert wird k nnen die Netze die vor der nderung geplant wurden im Produktionsplan NPRLIB und in der Ablaufdatei ABLDAT nicht wei terverarbeitet werden Dies gilt auch wenn von der unverschl sselten Speicherung der Kennw rter auf die Verschl sselung der Kennw rter umgestellt wird Bei einer Verfahrens nderung oder einer nderung des geheimen Schl ssels ist es sinnvoll die Produktionsbibliotheken NPRLIB und die Ablaufdatei und die Journaldatei zu l schen Die Ablaufdatei und die Journaldatei m ssen neu formatiert werden e Die Verschl sselung der Kennw rter erfolgt ber mit dem BS2000 Makro CRYPT Verschl sselt wird nur wenn die zugeordnete CLASS 2 OPTION gesetzt ist Dabei ist zu beachten dass die AVAS Prozesse DIALOG BATCH ZDL ZDD AVAK REPORT und REORG unter unterschiedlichen BS2000 Benutzerkennungen zum Ablauf gebracht werden k nnen Bei allen Benutzern muss der gleiche Wert f r PASSWORD encryption angegeben we
230. LOAD QUER U21462 J Z125 7 237 Arbeiten mit AVAS QUER Dienstprogramm AVAS QUER 5 1 3 Anweisungen eingeben Nach dem Start des Programms k nnen die AVAS QUER Anweisung SIGNON und die SDF Standardanweisungen angegeben werden Nach dem erfolgreichen Anmelden durch SIGNON wird die Anweisung CREATE FORMAT erwartet um das Format der Ausgabedatei en festzulegen Wenn CREATE FORMAT nicht angegeben wird werden die Ausgabedaten standardm ig im LOAD1 Format erstellt AnschlieBend kann auf den AVAS Datenbestand mit der AVAS QUER Anweisung SELECT OBJECT zugegriffen werden um die gew nschten AVAS Objekte auszuw hlen Die mehrmalige Angabe der Anweisungen SIGNON und SELECT OBJECT ist m glich Die Anweisungen mit ihrer Syntax und Parameterbeschreibung sind ab Seite 240 beschrieben 5 1 4 Beenden von AVAS QUER Das Programm AVAS QUER wird mit der Anweisung END beendet 5 1 5 Aufbau der von AVAS QUER erstellten Ausgabedatei en Das Ergebnis des AVAS QUER Laufs sind selektierte Daten aus den AVAS Grunddaten die in relationalen Datenbanken weiterverarbeitet werden k nnen Diese Daten werden in Ausgabedatei en geschrieben die ber bestimmte Linknamen zugeordnet sein m ssen siehe Abschnitt Voraussetzungen f r den Start von AVAS QUER auf Seite 233 AVAS QUER ber cksichigt dabei Folgendes e F r Datenfelder die nicht versorgt sind NONE Leerzeichen werden keine Daten s tze in die Ausgabedatei en
231. LUESSEL 59 START PARAMETER ABLDAT 5595598 DS 0C SATZBESCHREIBUNG SATZ 59 S59SNTYT DS 0CL3 TYP TEXE S59SNTY DS X TYP CODE DS CL2 5595511 DS CL3 START INDEX S59SSYN DS CL3 SYNC INDEX S59SSTI1T DS 0CL10 STATUS 1 TE 5595511 DS X STATUS 1 CODE DS CL9 S59SST2T DS 0CL10 STATUS 2 TEXT 5595512 DS X STATUS 2 CODE DS CL9 S59SST3T DS 0CL10 STATUS 3 TEX 5595513 DS X STATUS 3 CODE DS CL9 S59SBEN DS CL2 BEENDIGUNGSGRUND S59SCKZ DS CL1 FUNKTION S59ACON DS XL2 ANZAHL ABHAENGIGKEITEN VORHANDEN S59ECON DS XL2 ANZAHL ABHAENGIGKEITEN ERFUELLT 559559 EQU 859859A NORMALE LAENGE DER DATEN DS CLA RESERVIERT S59SVTXT DS CL128 TEXT AUS DER SUBNET JVA S59SSCAT DS CLA CATID SUBNET JVA S59SSDAT DS CL8 START DATUM DES SUBNET 55955915 EQU 559859A SONDER LAENGE DER DATEN U21462 J Z125 7 213 Aufbau der History Datei Sicherung und Reorganisation 4 4 Aufbau der History Datei Zus tzlich zum AVAS Journal beschreibt AVAS eine komprimierte Datei mit folgendem Inhalt e Ein komprimierter Satz f r jede Planungsvar
232. M VA AVSR NOSUBMIT 88 AVSQNOFO VALU AVSR NOTFOUND 88 AVSQLCKD VALUE AVSR LOCKED ij C 15 AVSERLTT PICTURE X 12 10 FILLER PICTURE X 16 We END OF COPY ELEMENT AVSCOBRT RE 438 U21462 J Z125 7 11 Plattform bergreifende Jobsteuerung mit AVAS SV F r den Start und die Kontrolle von Abl ufen unter Server Systemen werden drei Schnitt stellen angeboten 1 eine Server Schnittstelle mit einem AVAS Server in einem UNIX oder Windows Sys tem eine Server Schnittstelle mit einem AVAS Server in einem entfernten BS2000 System 3 eine JV Schnittststelle Hierbei wird das Starten und berwachen des Jobs im Server System ber eine BS2000 Prozedur abgewickelt Das Ergebnis wird ber die JV Schnittstelle an die AVAS Ablaufsteuerung zur ckgeliefert siehe Abschnitt AVAS Schnittstelle f r externe Server auf Seite 523 U21462 J Z125 7 439 AVAS SV Plattform bergreifende Jobsteuerung BS2000 OSD mit AVAS Server Systeme AVAS UNIX Windows System Ablauf AVAS SV steuerung gt avsrecv Abwicklung von Server Jobs l Oe Sohn Prozess AVAS Agent 4 avsstrt AVSSINCM Server Job entf BS2000 System AVAS SV BS2 avsrecv Server Job Fremd System Abwicklung USER Prozedur FT bzw von Server Jobs FT bzw 4 Steuerung im ber die gt Schnittstelle Fremdsystem AVAS JV zur Steuerung Schnittstelle t Ergebnis in JV Server Job
233. MAREA Kommunikationsbereich 0 comm pw 454 460 CONDITION JVA NAME 528 CONDITION TEXT 8 CONDITION TYPE 529 CONDITION VALUE 529 CONFIG Aktualisierung der Serverumgebung 2 CONFIG FILE NAME 120 CONFIG FILE PASSWORD 120 control time 35 COPY ELEMENT BATCH Anweisung 318 CREATE FORMAT AVAS QUER Anweisung 242 CREATE GENPAR 48 CREATE PERIOD BATCH Anweisung 320 CREATE PLAN NET BATCH Anweisung 325 Programmschnittstelle 3 CREATE PROD JOB BATCH Anweisung 327 CREATE PROD NET BATCH Anweisung 328 Programmschnittstelle 3 CRYPT 21 D Darstellungsmittel 11 Datei MFHSROUT 67 Dateierweiterung 5 U21462 J Z125 7 in Systembibliotheken bearbeiten 8 Encryption 21 END BATCH Anweisung 333 Programmschnittstelle 3 END Reorganisationsanweisung ENTER Datei f r Zugriffsprozesse ENTER FILE 9 ENTER PARAMS 529 ENTER Taste 9 Ereignis vom Server System an AVAS signalisieren 6 Ergebnisbereich Ergebnistabelle 2 f r Netzfunktionen definieren 7 Ergebnisbereich OUTAREA 382 Ersatzzeichen f r variable Periode 0 erstellen Datentr gerlisten 267 EXIT Modul 77 Konfigurationsdatei 0 variable Periode 0 Exit Modul 74 Binderanweisungen 77 erstellen 77 Zuordnung RZ Exits 75 EXTERNAL FILE 529 externe Erstellung von Auftr gen 372 von Dokumenten 372 von Netzen 347 171 107 F F 44 Fachw rter 527 Fehlerbehandlung in AVAS QUER 256 Fehlerfall Verhalten im 514 FHS DOORS 64 65 FILE PASSWORD 529 formatieren Ablaufda
234. MAREN Katalog derselben Kennung zugeordnet e Das MAREN System ist nicht betriebsbereit z B Steuerprogramm nicht geladen MAREN Katalog geschlossen e MARENAV stellt anhand des CLOSE Indikators im Archiveintrag eines Datentr gers fest dass die zugeh rige Datei bei der Erstellung nicht oder nicht ordnungsgem geschlossen wurde In diesem Fall liegt eine Eingabedatei vor da im DVS Kommando der Platzhalter VOL angegeben wurde Die VSNs einer Banddatei werden grunds tzlich nur einmal innerhalb eines Netzes ber pr ft und zwar beim ersten Kommando bei dem der entsprechende Datentr ger angespro chen wird Wenn ein Datentr ger in einem Folgejob desselben Netzes ein weiteres Mal ver wendet wird werden keine erneuten MAREN Pr fungen durchgef hrt Wenn die von MAREN reservierten Datentr ger Ausgabeb nder oder Kassetten sind ist keine der oben genannten Pr fungen notwendig MAREN hat bei der Reservierung alle Pr fungen bereits durchgef hrt U21462 J Z125 7 260 Kopplung AVAS mit MAREN Durchf hren von Datentr gerpr fungen Eine sinnvolle Durchf hrung der Datentr gerpr fungen ist nur dann m glich wenn die Archiveintr ge im MAREN Katalog aktuell sind d h den tats chlichen Dateistand der zugeh rigen B nder wiedergeben Dies ist z B dann nicht mehr der Fall wenn B nder aus geliehen und in einem anderen Rechenzentrum beschrieben wurden oder wenn die Band verarbeitung vor bergehend ohne das MAREN Sy
235. METER amp SYSPAR amp SYSPAR AVAS USER SYSPAR REMARK NAME DER DATEI ZUKUENFTIGE NEUE GENPAR amp GENNEW amp GENNEW AVAS USER GENPAR NEW OLD GENPAR AVAS USER GENPAR OLD SYSPAR AVAS USER SYSPAR NEW GENPAR AVAS USER GENPAR NEW BLS0500 PROGRAMM AVASCGP VERSION V7 0A VOM 2005 03 31 GELADEN BLS0552 COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2005 ALLE RECHTE VORBEHALTE AVS2201 START AVASCGP V7 0A00 2005 04 04 11 56 44 AVS8301 EINGABE UPDATE USER YES AVS8301 EINGABE UPDATE FUTAB YES AVS8301 EINGABE UPDATE USVAR YES AVS8301 EINGABE END AVS2310 SYSTEM AVASCGP V7 0A00 NORMAL BEENDET nm 52 U21462 J Z125 7 Installation und Generierung Generierung des AVAS Systems 2 2 5 Einrichten und Formatieren der AVAS Dateien Bei den Dateien des AVAS Systems ist zu unterscheiden zwischen Systemdateien NETSYS DOCSYS JCLSYS und JMDSYS die nur der AVAS Administrator andern und auswerten kann und Dateien mit Benutzerdaten die der Benutzer ndern oder zumindest auswerten kann Der Zugriff auf die Dateien mit Benutzerdaten erfolgt innerhalb AVAS nicht direkt aus den Dialog Verarbeitungs bzw Auswertungsprogrammen sondern ber zentrale Zugriffspro zesse ZDs Die Verbindung zwischen den Progammen und den zentralen Zugriffsprozes sen erfolgt ber ein Interface ZDI das die Anforderungen der Programme ber die ITC Schnittstelle an den zentralen Z
236. MODE ANY AVAK NAME amp AVS AVAK NAME FILE NAME amp AVS AVAK FILE FILE PASSW amp CAVS AVAK FILE PASSW JOB ID amp AVS JOB ID JOB INDEX amp AVS JOB INDEX JOB NAME amp AVS JOB NAME JOB TYPE amp AVS JOB TYPE JV PASSW amp AVS MONJV PASSW NET NAME amp AVS NET NAME SERVER NAME amp CAVS SERVER NAME SERVER PASSW amp CAVS SERVER PASSW SERVER PARA amp CAVS SERVER PARAM SERVER VERSION amp CAVS SERVER VERSION SYSTEM ID amp CAVS SYSTEM ID AVAS VERSIO amp AVS AVAS VERSION JOB CLASS amp AVS JOB CLASS JOB LOG amp AVS JOB LOG JOB PARAMETER amp AVS JOB PARAMETER USER ACCOUNT amp AVS USER ACCOUNT USER IDENTIFICATION amp AVS USER ID USER PASSW amp AVS USER PASSW DEFAULT COMM PASSW amp CAVS DEF COMM PASSW DEFAULT DIRECTORY amp AVS DEF DIRECTORY DEFAULT HOST NAME amp CAVS DEF HOST NAME DEFAULT SERVER PASSW amp CAVS DEF SERVER PASSW DEFAULT SERVER VERSION amp AVS DEF SERVER VERS DEFAULT PORT NR amp CAVS DEF PORT NUMBER DEFAULT USER ID amp CAVS DEF USER ID SVD0G JV amp AVS SVDOG JV END ASSIGN SYSDTA PRIMARY REMOVE FILE LINK LINK NAME AVSXID REMOVE PASSWORD PASSWORD amp AVS CONF PASSW SKIP COMMANDS TO LABEL ZSW29SET IF JOB SWITCHES ON 29 CALL PROCEDURE LIBRARY ELEMENT ELEMENT AVS SIGNAL LIBRARY amp USERID SYSPRC AVAS 070 m PROCEDURE PARAMETERS CUSERID amp USERID e CNTAPP amp C
237. MS0502 REQUESTED CATALOG IN QUIET OR HOLD MODE WAITING TIME IS OVER COMMAND NOT PROCESSED DMS0503 MRSCAT CONTAINS INCORRECT INFORMATION COMMAND REJECTED DMS0504 CATALOG MANAGEMENT SYSTEM ERROR COMMAND TERMINATED DMS0505 CMS RETURNED ERROR IN THE MRS COMMUNICATION FACILITY TO THE COMMAND PROCESSING DMS0512 REQUESTED CATALOG CANNOT BE FOUND COMMAND TERMINATED 262 U21462 J Z125 7 Kopplung AVAS mit MAREN Eintragen von VSNs in die JCL 6 2 Eintragen von VSNs in die JCL In die DVS Kommandos siehe Seite 259 k nnen ber folgende Platzhalterzeichen VSNs in die JCL der Jobs eingetragen werden e 4 VOL oder f VOL n bei Eingabeb ndern e SCR oder SCR n bei Ausgabeb ndern Diese Platzhalter d rfen nicht als Bemerkungszus tze in den von MARENAV ausgewerte ten DVS Kommandos verwendet werden Beim Eintragen werden die VSNs auch wenn es sich nur um eine VSN handelt immer in Klammern eingeschlossen Soll MARENAV insbesondere wenn die Platzhalterzeichen verwendet werden im MRS f higen AVAS sinnvoll eingesetzt werden gilt folgende Voraussetzung Alle Rechner an denen die durch eine Netzfreigabe angesprochenen Jobs ablaufen sollen m ssen zu einem MAREN Verbund zusammengeschlossen sein d h denselben MAREN Katalog verwenden Andernfalls werden z B durch SCR Datentr ger zum Zeitpunkt der Netzfreigabe reser viert die beim sp teren Ablauf des Netzes nicht im MAREN Katal
238. N amp SPSE REMARK NAME DER AUSGABEDATEI FUER ORDERTEXTTAB amp ORDERTXT ZSET ETLE LI LINK AVSORDX F NAME amp ORDERTXT MODIFY FILE ATTRIBUTES FILE NAME amp ORDERTXT SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMARK SYSTEMPARAMETER VERARBEITEN YES NO amp SYS 3 SKIP COM TO LABEL FAS amp SYS FASYE REMARK FASY REMARK REMARK NAME DER AUSGABEDATEI FUER CALTAB amp CAL SET FILE LINK LINK AVSCAL F NAME amp CAL MODIFY FILE ATTRIBUTES FILE NAME amp CAL SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE U21462 J Z125 7 235 Arbeiten mit AVAS QUER Dienstprogramm AVAS QUER FASNO REMARK FASN REMARK FA ENDE REMARK REMARK USERID AUF DER AVAS QUER INSTALLIERT IST amp AVUSERID 4 MODIFY TERMINAL OPTIONS OVERFLOW CONTROL NO SET JOB STEP SET FILE LINK F NAME amp AVUSERID amp SYSLNK amp SYSVER LINK SYSLNK ASSIGN SYSDTA TO FILE amp SYSCMD amp EXEC PROG FROM FILE PHASECELEM AVAS SYS LOAD QUER LIB amp AVUSERID SYSPRG AVAS amp SYSVER SYSTEM 5 SET JOB STEP REMOVE FILE LINK SYSLNK ASSIGN SYSDTA TO FILE PRIMARY SET JOB STEP SKIP COM TO LABEL FE amp FORMAT FEINSERT REMAR FEI REMAR
239. NSFER PROCEDURE NAME 118 TRANSFER PROCEDURE PASSWORD 119 TRANSFER Programm 137 beenden 149 starten 148 Transportliste 9 U bersicht BATCH Anweisungen 312 Journals tze 191 Protokollstatus 154 REPORT Anweisungen 283 Satzschl ssel 189 bersichtsverarbeitung Standardwerte 38 berwachung Ablaufsteuerung ber Jobvariable 35 Batch Prozesse ber Jobvariable 3 Prozesse ber Jobvariable 3 UNIX Windows Server Ablaufsteuerung 441 unterbrechen Dialog 30 UPAM ZD 53 USER 537 USER Parameter f r R 3 497 U21462 J Z125 7 Stichw rter Startparameter f r AVSSINCM Forts CNTAPP 465 USERID 465 Startparameter Dialogprozess 106 Startprozedur AVAS QUER 234 f r Ablaufsteuerung anpassen 521 f r AVSSINCM 463 f r AVSSINCM anpassen 521 Starttermin symbolischer 537 Startzeit aufgel ste 527 statische Jobs 537 Status Protokolleintr ge 140 Protokolleintr ge Priorit t 141 Server Job SV Status 455 steuern freigegebene Netze ber INFORM PROG 130 Protokollverarbeitung ber Startparameter 118 Zusammenarbeit mit Server Rechnern 119 Strukturelement 530 537 SUBMIT NET BATCH Anweisung 342 Programmschnittstelle 373 Subnetz 537 Serialisierung 110 symbolische Namen AVAS Anweisungen 44 AVAS Variablen 44 Benutzerdateien 53 symbolische Starttermine 537 Symdat 231 247 325 537 SYMDAT NAME 537 SYNC INDEX 537 SYSOUT Dateien 141 SYSOUT Protokoll 141 Systembeendigung 104 Systembenutzerkreis Elemente 28 Name 27 Schl
240. Netzstruktur ber Symdat S 101 Datum f r EARLIEST START in der Form jjmmtt S 102 Zeit f r EARLIEST START in der Form hhmmss Erweiterung AVAS QUER Die Strukturen folgender Tabellen wurden erweitert caldaysymtab Zuordnung der Symdats zu Kalendertagen ordersymtab Zuordnung von Symdats zu Strukturelementen ordertab Zuordnung von Pubsets zu Jobs und von Jobs zu Netzen ordertexttab Zuordnung von Texten der Netzbeschreibung zu den Strukturelemen ten der Netze Siehe Abschnitt Aufbau der Datenbanktabellen auf Seite 248 RUN CONTROL SYSTEM und Benutzerkreis merken f r Folgemaske Bei den Anweisungen bleibt der Wert f r RUN CONTROL SYSTEM und den Benutzer kreis im Parameter NET NAME als Standardwert bis zur n chsten expliziten nderung erhalten siehe Handbuch AVAS Anweisungen 1 Einleitung U21462 J Z125 7 Anderungen gegen ber der vorigen Handbuchausgabe Einleitung Kennw rter sollen sichtbar sein Die BS2000 Kennw rter k nnen in der Netzbeschreibung sichtbar gemacht werden Diese M glichkeit ist ber die Datei AVAS USER GENPAR einstellbar siehe Seite 30 und Handbuch AVAS Anweisungen 1 Vergleichsoperatoren beim Vergleich mit Werten einer JV COND TYPE JVA Bei Strukturelementen vom Typ JVA wird eine Jobvariable mit einem Wert verglichen Bei diesem Vergleich sind neben gleich wie bisher folgende Operatoren zugelassen kleiner gr er kleiner o
241. O AVSCMDC MOVE USER ID 10 AVSCAUID MOVE PASSWORD TO AVSCAUPN MOVE SYSTEM ID 10 AVSCASID 419 U21462 J Z125 7 Cobol Schnittstelle Programmschnittstelle von AVAS CALL AVASBCOB USING AVASBCOM AVASBOUT AVASBWRK IF AVSQOK THEN NEXT SENTENCE ELSE GO TO ERROR CALL AVAS FOR SUBMIT NET MOVE LOW VALUE TO AVSCAREA MOVE ASSIGN SUBMIT TO AVSCMDC MOVE NET NAME TO AVSCNETN MOVE MAX RESULT COUNTER TO AVSONECT CALL AVASBCOB USING AVASBCOM AVASBOUT AVASBWRK IF AVSQOK THEN NEXT SENTENCE ELSE GO TO ERROR ENDE CALL AVAS FOR END MOVE ASSIGN END TO AVSCMDC CALL AVASBCOB USING AVASBCOM AVASBOUT AVASBWRK STOP RUN ERROR END PROGRAM AVSCOBOL 420 U21462 J Z125 7 Programmschnittstelle von AVAS Cobol Schnittstelle 10 4 COPY Elemente f r Anweisungen AVSCOBAD Eintrag im Netzverzeichnis der Ablaufdatei definieren Das COPY Element AVSCOBAD definiert einen Eintrag des Netzverzeichnisses der Ablaufdatei Aufruf COPY AVSCOBAD Aufl sung des COPY Elements AVSCOBAD COPY AVSCOBAD AVSCOBAD 003 000331 47105171 AVAS U COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED
242. O TO LABEL SW31SET IF JOB SWITCHES CON 31 SKIP CO TO LABEL ABEND SW31SET REMAR WRITE TEXT gt AVAS ABLAUF MIT ERROR MODIFY JOB SWITCHES OFF 31 SET JOB STEP ABEND CANCEL PROC ENDE END PROC Die Batch Anweisungen f r den Prozeduraufruf k nnen ber eine Datei unter amp CMDFILE zugewiesen oder aus der Prozedur direkt eingelesen werden U21462 J Z125 7 343 Fehlerinformation bei den BATCH Funktionen BATCH Funktionen Beispiel Beispiel f r Batch Anweisungen um das Netz ABR JOB EXT zu planen zu produzie ren und freizugeben SIGNON AVAS USER ID USER2 PASSWORD FSC AVAS SYSTEM ID AVASO70 CREATE PLAN NET ET NAME A1 ABR JOB EXT CREAT m gt T U I r e T m SUB rm x Se T END 8 3 Fehlerinformation bei den BATCH Funktionen Bei der Verarbeitung von AVAS Anweisungen ber BATCH werden alle Meldungen die einen Fehler anzeigen nach SYSOUT ausgegeben Ein Fehler ist immer dann gegeben wenn ein Element nicht ordnungsgem verarbeitet werden kann Die Meldungen werden auch dann ausgegeben wenn sie im Dialog wegen der Abarbeitung einer Element ber sicht unterdr ckt werden Die Meldungsausgabe innerhalb der BATCH Funktionen ent spricht damit der Meldungsausgabe bei der Verarbeitung eines Elements im Dialog Unabh ngig davon wird nach der Verarbeitung von Elementen ber eine BATCH Anwei sung f
243. ON JV NAME Cjvname Ausgabe jvvalue 2 Status des Prozesses STARTED Der Prozess wurde gestartet und befindet sich in der Initialisie rungsphase READY Der Prozess ist betriebsbereit kein Benutzer ist aktiv bzw kein Netz im Ablauf RUNNING Mindestens ein Benutzer ist aktiv oder ein Netz befindet sich im Ablauf ENDED Der Prozess hat sich normal beendet ABENDED Der Prozess hat sich abnormal beendet STOP Beendigung des Prozesses wurde gefordert nur Ablaufsteuerung Der Prozess beendet sich wenn kein Netz Job mehr im Ablauf ist HOLD ZDs Eine Anmeldesperre f r alle Benutzer wurde gesetzt Benutzer k n nen sich erst wieder anmelden wenn die Anmeldesperre aufgeho ben ist Ablaufsteuerung Anhalten der Verarbeitung wurde gefordert Es werden keine weiteren Netze Jobs mehr gestartet RESUME Die Anmeldesperre wurde aufgehoben Benutzer k nnen sich wie der anmelden nur ZDs RESUMED Die Bearbeitung weiterer Netze Jobs erfolgt nach einem HOLD nur Ablaufsteuerung CANCEL SOF Die zwangsweise Abmeldung der Benutzer wurde gefordert Die Benutzer werden abgemeldet wenn sie kein Element mehr bear beiten U21462 J Z125 7 133 Bedienen und berwachen der AVAS Prozesse Administration von AVAS CANCEL HAR Die zwangsweise Abmeldung der Benutzer wurde gefordert Die Benutzer werden mit dem n chsten Dialogschritt abgemeldet An derungen an den aktuell bearbeiteten Elementen gehen verloren SHUTDOWN Beendigung des Pr
244. OUT ERROR ERR SUN EQU CALL AVAS BAL R14 DEL BCOM MVI AVSCMDC AVSQEND LA R1 PARAM L R15 V AVASBASS BALR R14 R15 CLI AVSRFDBI AVSQ10K BNE ERR END ERR SGN EQU ERR END EQU TERM SUB ROUTINE DEL BCOM EQU LA R2 AVASBCOM LA R3 AVSR QCL LA RA CS BLANK LA R5 L CS BLANK ICM R5 B 1000 CS BLANK MVCL R2 RA BR R14 SAVE AREA SAVEAREA DS 18F PARAMETER LIST PARAM DS OF PADRBCOM DC ACAVASBCOM PADRBOUT DC ACAVASBOUT PADRBWRK DC A AVASBWRK DC DEFINITION ANZ RSLT DC YL2 MAX RSLT CS BLANK DC CL4 CS USRID DC CL8 TEST CS USRPW DC CL8 TEST CS SYSID DC CL7 SYSIDAV CS NETNM DC CL32 TEST NET CS PERNM DC CL37 LTORG 388 Programmschnittstelle von AVAS Assembler Schnittstelle AV A S DEFINITION AVSASSBC AVSASSBO AVSASSRT DS 19CLCL AVSERSLT EQU AVSERSLT L AVSERSLT AVSASSBW COUNT O END AVASBCOM AVASBOUT MAX RSLT AVASBWRK 10 3 2 Makros zur Definition der Verst ndigungsbereiche AVSASSAD Eintrag im Netzverzeichnis der Ablaufdatei definieren Makroaufruf zur Adressierung der Eintr ge im Netzinhaltsverzeichnis Makro Parameter AVSASSAD MF C D PREFIX A char 1 gt MACID VSD lt char 3 gt EQU NO YES MF Der Parameter MF steuert die Code Generierung Makroform Cc Das Layout der Datenstruktur in der Regel der Parameterbereich wird er
245. PE STD i TYPE MOD TYPE EXT ORG AVSNVANF AVSNCJLD DS CL8 DATE JOB START YYYYMMDD AVSNTSN DS CLA TSN JOB STAR AVSNCJCR DS X CONDITION JOB CREATION STATE AVSNJENT DS X ENTER PARAMS AVSNJUSE DS CL8 JOB USER AVSNJACC DS CL8 JOB ACCOUNT AVSNJCAT DS 0CL6 JOB CATID AVSNJCTK DS CE CATID PREFIX AVSNJCTI DS CLA CATID VALUE DS CU CATID SUFFIX AVSNJCLA DS CL8 JOB CLASS AVSNJLGM DS CL8 JOB LOG AVSNJPAR DS CL128 JOB PARAMETER AVSNJFIL DS CL54 JOB ENTER FILE NAME FUNCTION S TYPE NET ORG AVSNVANF AVSNSNLD DS CL8 DATE SUBNET START YYYYMMDD DS CL6 AVSNSUSE DS CL8 SUBNET USER AVSNSACC DS CL8 SUBNET ACCOUNT AVSNSSRV DS 0CL8 SUBNET SERVER AVSNSCAT DS 0CL6 SUBNET CATID AVSNSCTK DS C CATID PREFIX AVSNSCTI DS CLA CATID VALUE DS CU CATID SUFFIX AVSNSCLA DS CL8 SUBNET CLASS AVSNSLGM DS CL8 SUBNET LOG AVSNSPAR DS CL128 SUBNET PARAMETER ORG AVSNVANF L AVSNVANF DS 0C Erl uterung der Status Anzeigen NSTT X Aktueller Verarbeitungsstatus des Strukturelements wenn es der normalen Verarbeitung unterliegt Der Status von Strukturelementen die nicht zur Verarbeitung kommen NO PLAN NO SUBMIT DELETED und IGNORED ist in NST3 abgelegt Wenn in NSTT HOLD gesetzt ist ist der Verarbeitungsstatus in NSTTS gesi chert Die Bedeutung der Schl sselw rter ist bei den Dialogfunktionen beschrieben Anweisung SHOW NET STATUS usw 397 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Sc
246. PLAN NET CREATE PROD NET SUBMIT NET und REPEAT NET werden serialisiert Die Anweisungen SUBMIT NET und REPEAT NET arbeiten mit dem gleichen Serialisierungsbegriff Gleichzeitig gestartete Anweisungen mit dem gleichen Serialisierungsbegriff werden nacheinander abgearbeitet Bei Hypernetzen wird die Serialisierung f r jedes Subnetz beim Start der Verarbeitung gesetzt und nach der Verarbeitung eines Subnetzes wieder freigegeben Bei dieser Freigabe wird f r das zugeordnete Hypernetz die Serialisierung ebenfalls wieder frei gegeben Start Parameter f r den Serialisierungsablauf Der Serialisierungsablauf wird durch folgende zwei Parameter gestartet MAX SERIAL LOCK t lock Mit MAX SERIAL LOCK wird die maximal zugelassene Bearbeitungszeit f r ein Netz festgelegt Wenn ein Benutzer bei der Bearbeitung eines Netzes die Serialisierung l nger belegt als mit MAX SERIAL LOCK zugelassen wurde wird die Verarbeitung planm ig beim Zeitablauf abgebrochen Der Benutzer wird zwangsabgemeldet und muss sich neu anmelden es wird keine Anmeldesperre beim Benutzer gesetzt Wenn ein Serialisierungsbegriff durch eine Anweisung belegt wird wird er beim Aufruf eines RZ Exits in CREATE PROD NET SUBMIT NET und REPEAT NET oder bei Ausgabe einer Benutzermaske CREATE PROD NET nicht freigegeben Dies ist beim Festlegen von MAX SERIAL LOCK zu ber cksichtigen Die maximalen Bearbeitungszeiten k nnen ber die Journale der Netze ermittelt wer den MA
247. Parameter ERROR INDEX AVSCERJN Parameter ERROR NAME AVSCLTI Parameter LIFE TIME Datum und Uhrzeit AVSCMDC Anweisungscode Schl ssel der Anweisung siehe Makro AVSASSBC auf Seite 400 bzw COPY Element AVSCOBBQ auf Seite 431 AVSCNETN Parameter NET NAME AVSCNST1 Parameter NET STATUS AVSCPERN Parameter PERIOD NAME AVSCRCSN Parameter RUN CONTROL SYSTEM U21462 J Z125 7 380 Aufbau der Verst ndigungsbereiche Programmschnittstelle von AVAS AVSCRSVT Parameter RESTART VARIANT AVSCSYDN Parameter SYMDAT NAME AVSCUSLB Parameter AVAS USER LIBRARY AVSCUSPF Parameter USER PAR FILE AVSRCMDT R ckgabe Anweisungstext Name der AVAS Anweisung AVSRFDBK R ckgabe Returncode der den Erfolg der Bearbeitung durch AVAS beschreibt AVSRDMSN R ckgabe DVS Meldungsnummer AVSRMSGN R ckgabe AVAS Meldungsnummer AVSRMSG1 R ckgabe 1 im Meldungstext eingef gter Wert AVSRMSG2 R ckgabe 2 im Meldungstext eingef gter Wert AVSRMSG3 R ckgabe 3 im Meldungstext eingef gter Wert AVSRNECT R ckgabe Anzahl der Elemente die zur Bearbeitung ausgew hlt wurden AVSRNEER R ckgabe Anzahl der Elemente die nicht richtig bearbeitet werden konn ten AVSRNEOK R ckgabe Anzahl der Elemente die fehlerfrei bearbeitet werden konnten AVSRRLTC R ckgabe RESULT Code der eine fehlerfreie Bearbeitung des Elements beschreibt Den Beschreibungen der einzelnen Anweisungen ist zu entnehmen welche Informationen bei einer Anweisung erforderlich
248. Produktionsplan bearbeitet wird geben ebenfalls Journals tze aus und ndern den Status des Netzes im Netzverzeichnis der Jour naldatei Netze werden bei den Anweisungen SUBMIT NET und REPEAT NET in die Ablaufdatei ABLDAT ausgegeben Alle nachfolgenden Anweisungen zur Steuerung der Netzverarbeitung erfordern eine Status nderung im Netzverzeichnis der Ablaufdatei und der Journaldatei und geben zus tzlich mindestens zwei Journals tze aus 160 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb Um kritische Betriebszust nde zu vermeiden sind folgende Regeln bei der Abarbeitung von Anweisungen ber AVAS BATCH zu beachten e Optimale Laufzeiten werden erreicht wenn jeweils nur eine Anweisung in nur einem Ablauf aktiv ist vollst ndige Serialisierung der Planung ber AVAS BATCH Dabei kann in keinem Fall ein Element gesperrt sein Eine vollst ndige Serialisierung aller Abl ufe mit BATCH Anweisungen wird erreicht wenn bei der Generierung MAX BATCH PROCESS 1 angegeben wird e Bez glich der Bibliotheken ergeben sich vergleichbar gute Zust nde wenn bei einer parallelen Verarbeitung die Netze ber den Parameter NET NAME gegen berschnei dungen abgegrenzt sind Lauf a NET NAME A1 Lauf b NET NAME A2 Die optimale Abgrenzung wird durch unterschiedliche Benutzerkreise erreicht denen unterschiedliche Bibliotheken NETLIB und NPRLIB zugeordnet sind Konkurrierende Zugriffe bei der Ausgabe von Jour
249. QUER MODIFY FILE ATTRIBUTES FILE NAME amp ORDERTUR SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 EMOVE FILE LINK AVSORDX MODIFY FILE ATTRIBUTES FILE NAME amp ORDERTXT SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 REMARK SYSTEMPARAMETER VERARBEITET YES NO amp SYS SKIP COM TO LABEL FES amp SYS J AEESYES REMAR FESY REMAR REMOVE FILE LI AVSCAL MODIFY FILE ATTRIBUTES FILE NAME amp CAL SUPPORT ANY DISK SPACE RELEASECNUMBER OF PAGES 9999 FESNO REMAR FES REMAR FE ENDE REMAR SET JOB STEP MODIFY TERMINAL OPTIONS OVERFLOW CONTROL USER END PROC 1 Angabe des Formats in dem die Ausgabedatei en erstellt werden Folgende Angaben sind m glich I oder load Die Ausgabedateien werden im LOAD Format erstellt AJ oder insert Die Ausgabedatei wird im INSERT Format erstellt 2 Abh ngig von der Formatangabe werden jetzt entweder der Name der Ausgabe datei im INSERT Format oder die Namen der Ausgabedateien f r die einzelnen Datenbanktabellen im LOAD Format abgefragt Die Zuordnung zu den Link namen wird getroffen 3 Angabe ob die System Parameter verarbeitet werden sollen Dies ist der Fall wenn bei der Anweisung SELECT OBJECT der Parameter SYSTEM PARAMS YES angegeben wird Es sind die Angaben YES oder NO m glich 4 Angabe der Benutzerkennung unter der AVAS installiert ist 5 Starten von AVAS SYS
250. QlOK EQU X 00 NO ERROR AVSQlFCT EQU X 04 ERROR FUNCTION AVSQlOUT EQU X 08 ERROR OUT AREA AVSQIWRK EQU X OC ERROR WRK AREA AVSQ1SYS EQU X 12 ERROR AVAS SYSTEM FEEDBACK CODE2 AVSRFDB2 DS FEEDBACK 2 EQUATES ARE VALID IF OK IS SET IN FEEDBACK 1 AVSQ2NOK EQU X 04 FUNCTION WITH WARNING RESUL EQUATES ARE VALID IF FCT IS SET IN FEEDBACK 1 AVSQ20K EQU X 00 NO ERROR AVSQ2CMD EQU X 0l ERROR CMD U21462 J Z125 7 400 Programmschnittstelle von AVAS Assembler Schnittstelle AVSQ20PR EQU X 02 ERROR OPR AVSQ2PRM EQU X 03 ERROR PARAMS AVSQ2FCT EQU X 04 ERROR FUNCTION AVSQ2TMO EQU X 05 ERROR TOO MANY OPERANDS EQUATES ARE VALID IF OUT IS SET IN FEEDBACK 1 EQUATES ARE VALID IF WRK IS SET IN FEEDBACK 1 EQUATES ARE VALID IF SYS IS SET IN FEEDBACK 1 AVSQ2ERR EQU X 01 ERROR AVSQ2DMS EQU X 02 ERROR DMS DS AL2 RESERVED DS Cl4 RESERVED AVSRNECT DS H COUNTER NET ELEMENT FOUND AVSRNEOK DS H PROCESSED AVSRNEER DS H INVALID AVSRRLTC DS X RESULT CODE NET ELEMENT OK DS X RESERVED AVSRDMSN DS CL4 DMS MESSAGE NUMBER AVSRMSGN DS CL4 AVAS MESSAGE NUMBER AVSRMSGl DS CL30 E 0 INSERT 1 AVSRMSG2 DS CL30 28 INSERT 2 AVSRMSG3 DS CL30 TENE INSERT 3 DS CL30 RESERVED RESULT FIELD OPERAND ERROR AVSRNETN DS X NET NAM
251. R Generell wird die Beschreibung aus der SYSPAR Datei verwendet Das Ende der Beschrei bung Klammer zu ist nicht auf einer festen Position sondern liegt unmittelbar hinter der beschriebenen Variablen Beschreibung einer Funktionstabelle Generell wird die Beschreibung aus der SYSPAR Datei verwendet Hinweis Die alte GENPAR Datei muss nicht die Beschreibung eines kompletten AVAS Systems enthalten sie kann auch nur die in diesem Programm behandelten Anweisungen ent halten Wenn z B die alte GENPAR Datei nur aus einer Kommentarzeile besteht ber nimmt das Generierungsprogramm die zu bearbeitenden GEN Anweisungen USER USVAR usw nur aus der SYSPAR Datei und die GEN Anweisungen werden als neue GENPAR Datei erstellt F r eine sinnvolle Verwendung muss diese Datei dann aber manuell in eine GENPAR Datei zur AVAS Systemgenerierung eingebracht werden 50 U21462 J Z125 7 Generierung des AVAS Systems Installation und Generierung 2 2 4 2 Prozedur zum Erstellen von GENPAR Beschreibungen Mit der Prozedurdatei AVS CREATE GENPAR Element in der Bibliothek SYSPRC AVAS 070 wird das Programm aktiviert mit dem aus einer alten GENPAR Datei und einer SYSPAR Datei eine neue GENPAR Datei erstellt werden kann Um das Programm zu steuern werden ber Prozedurvariable Informationen vorgegeben bzw angefordert Dies sind im Einzelnen Name einer ISAM Datei SYSPAR Eingabedatei mit generierten System Parametern Name einer SAM Datei
252. R VOL vsn FILE NONE zu l schen U21462 J Z125 7 275 Erstellen von Datentr gerlisten Kopplung AVAS mit MAREN Wenn der Datentr ger nicht mehr ben tigt wird sollte zugleich auch das Datentr ger Frei gabedatum FREE DATE und falls notwendig auch das Datei Freigabedatum EXPIRATION DATE mit der MAREN Anweisung MOD VOL ATTR VOL vsn FILE NAME NONE FREE DATE 0 EXP IR DATE 0 zur ckgesetzt werden Damit wird der Datentr ger beim n chsten Freigabelauf durch den MAREN Administrator freigegeben Wenn es sich um mehrere Ausgabeb nder handelt ist diese Aktion f r jedes einzelne Band durchzuf hren Weiterverarbeiten einer Ausgabedatei Ein Netz besteht aus zwei nacheinander ablaufenden Jobs wobei im ersten Job eine Band datei erstellt wird die im zweiten Job als Eingabedatei verwendet wird Die Auswahl der VSNSs erfolgt wiederum mit den Platzhalterzeichen SCR und VOL Die Ausgabe darf in diesem Beispiel nur auf ein Band erfolgen und im MAREN Katalog d rfen keine Archiveintr ge mit den angegebenen Dateinamen vorhanden sein Beispiel f r Job 1 SET LOGON PARAMETERS REMARK ZUWEISEN DER PLATTEN EINGABEDATEI SET FILE LINK LINK NAME PCIN FILE NAME DATEII REMARK ZUWEISEN DER BAND AUSGABEDATEI CREATE FILE FILE NAME DATEI2 SUPPORT TAPE VOLUME SCR DEVICE T1600 SET FILE LINK LINK NAME PCOUT FILE NAME DATEI2 REMARK KOPIEREN AUSGEWAEHLTER SAET
253. RAMS hat Die BS2000 Kennw rter sind nach SIGNON immer dunkel gesteuert Der AVAS Benutzer kann sich die Kennw rter in einigen Masken mit der Operation VISIBLE bzw 71 anzeigen lassen sofern f r ihn password visibilityz YES eingestellt ist siehe auch die Beschreibun gen der Passwort Parameter im Handbuch AVAS Anweisungen 1 Allgemeine Parameter der Benutzer Mit den allgemeinen Parametern werden dem Benutzer Dateien zugewiesen in denen er seine Benutzermasken speichern kann sowie die Datei mit den Auskunftsfunktionen MAPnnnzdateiname Dateiname einer Benutzerbibliothek in der die Module der Benut zermasken gespeichert werden k nnen Mindestens eine MAPLIB f r Netz und f r Jobmasken muss in den System Parametern vor gegeben werden auch wenn diese Dateien in der Anwendung nicht ben tigt werden HLPLIB dateiname Datei SYMSH AVAS 070 mit den Textelementen f r die AVAS Aus kunftsfunktion Die Datei HLPLIB ist allen AVAS Benutzern zuge ordnet Der Zugriff auf die Datei erfolgt ber den zentralen Zugriffs prozess PLAM ZD Die Texte der deutschen und englischen Sprache werden ber die BS2000 Systemeinstellung ausgew hlt siehe BS2000 Kommando SHOW MSG FILE ASSIGNMENT Parameter SYSTEM LANGUAGES Diese Parameter k nnen im laufenden AVAS Betrieb durch die Anweisung MODIFY SYSTEM PARAMS ge ndert werden Nach einem Neuladen der zentralen Zugriffsprozes se f r Bibliothekszugriffe sind die neuen Dateien zugeordne
254. REIS 3NNAM DS CL32 NETZNAME 3NEND DS OF 3HNLN EQU N3SYSID LAENGE VORSPANN ORG N3NEND 4 F3S AVASJRN N3 VERSION 070 EQUSYES 3 SATZBESCHREIBUNG JOURNALSAETZE F3 3J0URN DS OF SATZBESCHR JOURNALSAETZE 3SLE DS H SATZLAENGENFELD DS OH RESERVIERT 3F4S DS X X EA WENN FORMAT MIT JAHRHUNDERT 35518 DS X SATZ STATUS 3RFAS DS CL2 BLANK WENN FORMAT MIT JAHRHUNDERT 3DTZ DS OCL14 DATUM ZEIT JHYYMMTTHHMMSS 3DAT DS 068 DATUM NEU JHYYMMTT 3DTJH DS CL2 JAHRHUNDERT JH 3DATUM DS CL6 DATUM YYMMTT U21462 J Z125 7 197 Sicherung und Reorganisation HHMMSS CH ZEIT ONTROL PROD JOB E PLAN Y PLAN E PLAN CT NET E PROD Y PROD E PROD T NET YS RAMS TU TDL Ev Era prd 1 1 1 1 1 BMIT NET LH TT ER NA CMD C IT EAT DIF LET ELE EAT DIF LET BM DIF A Ei E C
255. REPORT Generator werden ber SYSDTA eingelesen Die Menge der erforderlichen Anweisungen ist abh ngig vom zu erstellenden Report REPORT NAME und von den ausgew hlten Funktionen FUNKTION Die REPORT Anweisungen sind nur in der Form zugelassen anweisungsname wert oder anweisungsname liste Wenn eine REPORT Anweisung mehrfach eingegeben wird sind die zuletzt eingegebenen Werte g ltig Ausnahme Die Eingaben ber die REPORT Anweisung FUNKTION werden addiert Die Eingabe Parameter werden nicht ber SDF verarbeitet Fehlerhafte oder unzul ssige Eingaben werden protokolliert und die Verarbeitung wird abgebrochen Die Fehlerursache ist dem SYSOUT Protokoll zu entnehmen Fehlerhafte Eingaben k nnen auch dann nicht im Dialog korrigiert werden wenn die Report Prozedur im Dialog abl uft Beispiel f r die Eingabe der Anweisungen in der Prozedur BEGIN PROC LOGG COM PAR YESCPROC PAR amp REPORT ESC CHAR C amp ASSIGN SYSDTA TO FILE SYSCMD START PROG FROM FILE PHASE CLIB AVAS SYSPRG AVAS 070 SYSTEM ELEMENT AVAS SYS LOAD REPORT REPORT NAME OUT OF PLAN FUNKTIO ALL AVAS SYSTEM ID SYSNAME SYSTEM PASSWORD zs AVAS USER ID USERNAME USER PASSWORD C XXXXXX NET NAME ALL OUTPUT WORK FILE AVAS WORK OOP SORT STATE ORDER ERROR NO SUBMIT WAITING STARTED ENDED ABENDED SORT FIELDS ORDER STATE NET NAME E DELAY SELECT STATUS ERROR NO SUBMIT WAIT
256. RIBUTES MODIFY FILE GENERATION SUPPORT SETFILE LINK U21462 J Z125 7 259 Durchf hren von Datentr gerpr fungen Kopplung AVAS mit MAREN Ob ein Datentr ger verf gbar ist wird anhand folgender Kriterien festgestellt 1 VSN im MAREN Katalog enthalten 2 falls ja ist es ein reservierter Datentr ger RESERVED oder PRIVATE Eine berpr fung dieser Kriterien kann wahlweise ber den MAREN Parameter FOREIGN TAPE CHECK NO ausgeschaltet werden Wenn dieser Parameter auf YES gesetzt ist und eine der oben genannten Pr fungen negativ verl uft bricht MARENAV die Produktionsfreigabe ab Ist der Datentr ger verf gbar d h reserviert und im MAREN Katalog eingetragen werden zwei weitere Bedingungen gepr ft 3 Der Ger tetyp aus dem MAREN Archiveintrag muss mit dem Ger tetyp bereinstim men der im DVS Kommando angegeben wurde oder der dem Dateikatalogeintrag entnommen wurde 4 Der Datentr ger darf nicht ausgeliehen sein Wenn eine der beiden Pr fungen negativ verl uft wird die Produktionsfreigabe nicht abge brochen sondern ein entsprechender Hinweis f r die jeweilige VSN wird in die beiden von MARENAV erzeugten Datentr gerlisten aufgenommen Weitere Ursachen die zum Abbruch der Produktionsfreigabe f hren k nnen e Eine Datei besteht aus mehr als 255 Datentr gern e F reine Multivolume Datei sind nicht alle Folgespulen im MAREN Katalog eingetra gen e Nicht alle VSNs einer Multivolume Datei sind im
257. RINT FILE F NAME list datei CONTR CHAR EBCDIC Die gesicherten Journals tze kann der Benutzer auch mit eigenen Programmen auswer ten Der Aufbau der gesicherten Journals tze ist auf Seite 187 beschrieben Die Satzbeschreibung der gesicherten Journals tze ist durch den Makro AVASJRN definiert 185 U21462 J Z125 7 Sichern der Journale und Protokolle Sicherung und Reorganisation Sichern der Protokolldaten Die Protokolleintr ge und die Protokolldaten werden bei der Reorganisation gesichert wenn dies ber den Steuerungs Parameter verlangt wurde Dabei werden alle Daten der zu sichernden Protokolleintr ge in eine SAM Datei ausgegeben Die Sicherung eines Protokolleintrags hat folgenden Aufbau 1 Satz SYSLOG syslog daten Satz JOBLOG joblog daten Satz SAVLOG element name Satz funktion funktion daten nur soweit vorhanden o Bom bis n Satz Protokolldaten n 1 Satz SYSLOG ENDES syslog daten bzw SYSLOG ERROR syslog daten nur im Fehlerfall element name Name des Protokolls in der D Abteilung siehe Abschnitt Speichern der Protokolle auf Seite 137 syslog daten Daten des SYSLOG Satzes im Element der S Abteilung siehe Seite 138 joblog daten Daten des JOBLOG Satzes im Element der S Abteilung siehe Seite 138 funktion daten Daten des funktion Satzes im Element der D Abteilung siehe Seite 139 186 U21462 J Z125 7 Sicherung und Reorganisation Datenstru
258. RMSGN PICTURE X 04 0 AVSRMSGI PICTURE X 30 LO AVSRMSG2 PICTURE X 30 LO AVSRMSG3 PICTURE X 30 LO FILLER PICTURE X 30 LO FILLER 15 AVSRNETN PICTURE X 15 5 PICTURE X 5 AVSRPERN PICTURE X 15 AVSRSYDN PICTURE X 5 AVSREAS PICTURE X 15 AVSRUSPF PICTURE X 15 AVSRERJ PICTURE X 15 AVSRERI PICTURE X L5 AVSRRSV PICTURE X 15 AVSRUSLB PICTURE X 15 AVSRNSTI PICTURE X 15 AVSRCDNT PICTURE X 15 AVSRCDNM PICTURE X 15 AVSRCDNN PICTURE X L5 AVSRCDN PICTURE X 5 AVSRCDVL PICTURE X 5 AVSRLTI PICTURE X 10 FILLER PICTURE X 7 05 AVSCAREA 10 AVSCMDC PICTURE X 10 FILLER PICTURE XXX 10 AVSCPARI PICTURE X 92 10 FILLER REDEFINES AVSCPARI 15 AVSCAUID PICTURE X 08 15 AVSCAUPW PICTURE X 08 15 AVSCASID PICTURE X 07 1 5 FILLER PICTURE X 69 10 FILLER REDEFINES AVSCPARI 5 AVSCNETN PICTURE X 32 L5 65 PICTURE X 08 5 AVSCPERN PICTURE X 37 5 FILLER PICTURE X 15 10 AVSCPAR2 PICTURE X 96 10 FILLER REDEFINES AVSCPAR2 15 AVSCSYDN PICTURE X 20 15 5 PICTURE X 19 428 U21462 J Z125 7 Cobol Schnittstelle 429 ES AVSCPAR2 ES AVSCPAR2 ES AVSCPAR2 ES AVSCPAR3 E X 57 E X 54 E X 42 X 30 999 9 X 62 pr ITE TTT MT X 6 X 12 X 3 X 30 X 32 9 3 X 10 X 96 FTT TL TTTOITTY IT Ir E XC19 E X 74 E X 3 AVSCOBBC PICTU REDEF PICTU PICTU
259. ROCEDURE gestartet werden soll muss angegeben werden wenn das Programm TRANSFER als Folgejob ablaufen soll siehe Abschnitt Starten des SIGNAL Programms auf Seite 144 Parameter TRANSFER OPTION Es muss der vollst ndige Pfadname angegeben werden wenn die Prozedur nicht dort katalogisiert ist wo der AVAS Job gestartet wurde Zu beachten ist dass diese Prozedur von allen Kennungen und Rechnern die durch die Ablaufsteuerung angesprochen werden erreichbar sein muss In der Prozedur ist daf r zu sorgen dass bei einem Fehler z B Fehler beim Transfer wird ber Schalter 30 31 angezeigt der Job ablauf von der Ablaufsteuerung als fehlerhaft erkannt wird Hierzu ist die Auftrags Jobvariable ab Spalte 129 zu versorgen oder der Jobablauf hart zu beenden U21462 J Z125 7 118 Administration von AVAS Starten und Beenden der AVAS Prozesse TRANSFER PROCEDURE PASSWORD NONE Die Prozedur f r den TRANSFER Job ist mit keinem Kennwort gesch tzt kennwort Die Prozedur f r den TRANSFER Job ist mit einem Kennwort gesch tzt Das Kennwort ist in einer L nge von 4 Zeichen anzuge ben alphanumerisch C oder sedezimal X 0 Der Parameter wird nur ausgewertet wenn auch der Parameter TRANSFER PROCEDURE NAME dateiname angegeben wurde Hinweis Wenn im Zusammenhang mit GENERATE JOB LOG ALL bei der Kommunikation zwischen Ablaufsteuerung und der ZD f r PLAM Zugriffe ein Fehler auftritt wird eine Meldung ausgegeben
260. RVED PLAN DESCRIPTION INSEL DS C NET SELECT TURNUS LRWNW DS X RELATIV SYMDAT WORK NWRK LQNWR EQU 83 SELECT PLAN TYPE NWRK LQWRK EQU 84 WORK DS 602 RESERVED PSSY DS 44CL42 PLAN START PSSE DS 06 ORG J NNIPSSY SYMD DS 06020 SYMDAT NAME lt NAME NN gt RLDI DS 0 REAL START DATE IDENTIFICAT NNIRLDA DS CL6 REAL START DATE YYMMDD DS CL13 RESERVED NNISTIM DS CL6 SYMDAT START TIME HHMMSS NNILAST DS CL7 SYMDAT LATEST START lt DDDHHMM gt NNILTIM DS CL7 LIFE TIME lt DDDHHMM gt NNINDSL DS X NET DELAY SOLUTIO 350 U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen MEANING CANCEL WAIT START IGNORE NOT USED NET STR SE aE Et I DE E RESERVED RECORD LENGTH MINIMUM SEGM LENGTH DELAY SOLUTION C US 65 67 68 69 C NN1A NNISYMD NNIPSSE NNIPSSY NNICE L SEGM COUNTER 351 OF NN1A EQU EQU EQU EQU DS EQU EQU ORG EQU DS EQU Externe Erstellung von AVAS Elementen NNIEDSC NNIEDSW NNIEDSS NNIEDSI NNILMIN NNICESL NNICE Z NNIL U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen Externe Erstellung von AVAS Elementen AVASNET RECORD N2 MFCHK MF C C PREFIX N C MACID N2 E DMACID N2D C SUPPORT C D DS Op AHHHHE PREF
261. Rechnerkonfiguration die Server userid usw ndern Das hei t eine nderung der Netze ist nicht erforderlich wenn die Prozesse des Server Systems ab sofort auf einem anderen Rechner laufen sollen Es muss lediglich der Rech nername in der Konfigurationsdatei geandert werden Die Konfigurationsdaten k nnen auch als DEFAULT Parameter in der Startdatei f r AVSSINCM angegeben werden U21462 J Z125 7 454 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs Die Zusammenh nge bei der Kommunikation mit dem Server System sind dargestellt im Abschnitt Einsatzvorbereitung auf Seite 518 Ablaufsteuerung Die Ablaufsteuerung erkennt in einem aktiven Netz einen Server Job am Eintrag FUNCTION X oder der Angabe eines Servernamens bs2000 servername im Operanden NET CAT bzw JOB CAT bei der Netz bzw Job Beschreibung Wenn dieser Server Job in den AVAS Bibliotheken verwaltet wird schreibt ihn die Ablaufsteuerung in eine BS2000 Da tei Anschlie end startet sie AVSSINCM um die BS2000 Datei mit dem Server Job auf das Server System zu bertragen und den Server Job dort zu starten Die Ablaufsteuerung startet AVSSINCM ber eine S Prozedur mit dem Kommando ENTER PROC Die f r AVSSINCM notwendigen Anweisungen in der Prozedur sind ab Seite 463 beschrieben Der Name und das Kennwort f r die S Prozedur werden der Ablaufsteuerung mit den Parametern SERVER PROCEDURE NAME und SERVER PROCEDURE PASSWORD
262. Reorganisation SSL FNR Anweisung CANCEL NET Netzstatus vor Funktion Netzstatus nach Funktion Abbruch der Funktion Fehlermeldung HOLD NET Netzstatus vor Funktion Status Strukturelement nach Funktion Strukturelem status falsch Netzstatus nach Funktion Abbruch der Funktion Fehlermeldung RESUME NET Netzstatus vor Funktion Status Strukturelement nach Funktion Strukturelem status falsch Netzstatus nach Funktion Abbruch der Funktion Fehlermeldung START NET Netzstatus vor Funktion Netzstatus nach Funktion Abbruch der Funktion Fehlermeldung RESTART NET Netzstatus vor Funktion Status Strukturelement nach Funktion Strukturelem status falsch Restartpunkt Restartname Netzstatus nach Funktion Abbruch der Funktion Fehlermeldung 51 00 51 07 51 08 09 06 51 00 52 02 52 09 51 07 51 08 09 06 51 00 52 02 52 09 51 07 51 08 09 06 51 00 51 07 51 08 09 06 51 00 52 02 52 09 58 02 51 07 51 08 09 06 U21462 J Z125 7 Sicherung und Reorganisation Ausgabe im Datenbereich S55 AVASJR S55 AVASJR S54 AVASJR S54 AVASJR S54 AVASJR S56 AVASJR S56 AVASJR S53 AVASJR S53 AVASJR S57 AVASJR S57 AVASJR 555 AVASJR 55 AVASJR MSG7 Text 552 AVASJRN Anweisung ABLDAT Datenstrukturen Journalsicherung Not Journaldatei Anweisung MODIFY SUBMIT NET Start der nderung Wechsel RUN CONTROL SYSTEM Restartvarianten alt Restartvarianten ne
263. S DS DS EQU DS DS DS DS EQU EQU S52 S52S52A S52JCTYT S52JCTY S52JSTI S52JSYN S52JST1T S52JST1 S52JST2T S52JST2 S52JST3T S52JST3 S52JBEN S52JCKZ S52ACON S52ECON S52S52L S52JVTSN S52JVTXT S52JSCAT S52JSDAT S52S52LS S52LEN Datenstrukturen Journalsicherung Not Journaldatei 206 Sicherung und Reorganisation Datenstrukturen Journalsicherung Not Journaldatei Definitionen Satzschl ssel 53 ORG N3INH 53 AVASJRN S53 JOURNALSATZ SATZSCHLUESSEL 53 CONDITION ABLDAT ERSETZT SATZSCHLUESSEL 13 AB VERSION 02 0A 5535538 DS UC SATZBESCHREIBUNG SATZ 53 S53CTYPT DS 0603 COND TYPE JVA TEXT S53CTYP DS X COND TYPE JVA CODE DS GEZ S53CSY DS CL3 SYNC INDEX S53CNAM DS CL54 JVA NAME S53JVAP DS CL3 JVA POSITION S53JVAL DS CL3 JVA LENGTH S53JVAV DS CL
264. S Administratoren Inhalt Alle Aufgaben des AVAS Administrators von der Generierung des Systems bis zur Administration des AVAS Systems BDienstprogramm AVAS QUER Kopplung von AVAS mit MAREN AVAS Reports BATCH Funktionen Externe Erstellung von AVAS Elementen Programmschnittstelle AVAS SV AVAS SV BS2 Ausgabe Juni 2005 Datei avas adm pdf Copyright O Fujitsu Siemens Computers GmbH 2005 Alle Rechte vorbehalten Lieferm glichkeiten und technische Anderungen vorbehalten Alle verwendeten Hard und Softwarenamen sind Handelsnamen und oder Warenzeichen der jeweiligen Hersteller Dieses Handbuch wurde erstellt von cognitas Gesellschaft f r Technik Dokumentation mbH www cognitas de U21462 J Z125 7 Kritik Anregungen Korrekturen U21462 J Z125 7 Fujitsu Siemens Computers GmbH Handbuchredaktion 81730 M nchen Fax 0 700 372 00000 e mail manuals fujitsu siemens com http manuals fujitsu siemens com Absender Kommentar zu AVAS V7 0A AVAS SV V7 0A AVAS SV BS2 V7 0 AVAS f r den Administrator co FUJITSU Information on this document On April 1 2009 Fujitsu became the sole owner of Fujitsu Siemens Compu ters This new subsidiary of Fujitsu has been renamed Fujitsu Technology So lutions This document from the document archive refers to a product version which was released a considerable time ago or which is no longer marketed P
265. S SV f r UNIX Systeme Die Installation erfolgt durch den Aufruf der Installationsprozedur install avs von der CD ROM Die Installationspfade und Einstellungen werden von der Installationsprozedur erfragt Weitergehende Informationen k nnen der Readme Datei entnommen werden AVAS SV f r Windows Systeme Die Installation erfolgt durch den automatischen Aufruf eines Setup Programms nach dem Einlegen der CD in das CD ROM Laufwerk Die Installation ist men gef hrt Weitergehende Informationen k nnen der Readme Datei entnommen werden die auch im Rahmen der Installation zum Lesen angeboten wird AVAS SV f r BS2000 Systeme Der AVAS Server f r entfernte BS2000 Systeme AVAS SV BS2 wird mit dem Installati onsmonitor IMON installiert U21462 J Z125 7 13 Installation des AVAS Systems Installation und Generierung 2 1 2 R3JobControl Die Installation erfolgt auf UNIX Systemen durch den Aufruf der Installationsprozedur install avs von der CD ROM auf Windows Systemen durch den automatischen Aufruf eines Setup Programms nach Einlegen der CD in das CD ROM Laufwerk Die Installati onspfade und Einstellungen werden von der Installationsprozedur erfragt Weitergehende Informationen k nnen der Readme Datei README R3JobControl D E entnommen werden 2 1 3 Versionsabh ngigkeiten in AVAS Konfigurationen Nachstehend finden Sie einige Hinweise f r den Einsatz oder Austausch von AVAS Servern auf UNIX und Windows basierten Systemen D
266. S angegeben wurde SELECT OBJECT NET NAME NO netname CALENDAR NAME NO calendar SYSTEM PARAMS NO YES NET NAME bestimmt ob AVAS Netze ausgew hlt werden Die Wildcard Angabe ist zugelassen NET NAME NO AVAS Netze werden nicht ausgew hlt Wenn alle Netze ausgegeben werden sollen die mit NO enden muss NET NAME mit Benutzerkreis NET NAME bk NO angegeben werden NET NAME netname Name des AVAS Netzes in der Form bk netname ber den die Objekte ausgew hlt wer den Unter diesem Namen ist die Netzbeschreibung in der Netzbibliothek eingetragen Der Netzname kann auch teilqualifiziert angegeben werden CALENDAR NAME bestimmt ob AVAS Kalender ausgew hlt werden CALENDAR NAME NO AVAS Kalender werden nicht ausgew hlt CALENDAR NAME calendar Name des AVAS Kalenders der ausgew hlt wird Unter diesem Namen ist die Kalender beschreibung in der Kalenderbibliothek eingetragen Der Kalendername kann auch teilqua lifiziert angegeben werden U21462 J Z125 7 243 Dienstprogramm AVAS QUER Anweisungen von AVAS QUER SYSTEM PARAMS bestimmt ob aus den AVAS System Parametern die Zuordnung der Kalender zu Benutzer kreisen ausgew hlt wird SYSTEM PARAMS NO Es wird keine Zuordnung der Kalender zu Benutzerkreisen bernommen SYSTEM PARAMS YES Die Zuordnung der Kalender zu den Benutzerkreisen wird aus der System Parameterdatei in die Ausgabedatei bernommen Beispiel
267. SAVE DURCHFUEH REMARK amp DELJL DELETE JOB LOG DURCHF REMA WRITE TEXT FUNKTION amp FUNKTION SKIP COM TO LABEL F amp FUNKTIO FSJOUR REMARK amp JVZDD JV F MODIFY JV JV ID JVNAMECJV NAME amp JVZDD INCJRLDAT F amp FUNKTION REMAR SET FILE LINK LINK NAME SYSLNK FILE NAME SYSLNK AVAS 070 ASSIGN SYSDTA TO FILE SYSCMD START PROG FROM FILE ELEMENT AVAS SYS LOAD REORG AJ SYSID amp SYSID ZDD PASSWORD amp ZDDP ZDL PASSWORD amp ZDLP FUNKTION amp FUNKTIO ET NAME amp NETN DELETE PLAN NET amp DELPN U21462 J Z125 7 AVAS USER ID amp AVSID USER PASSWORD amp USRPW JOBLOG SAVE OPTION amp JLSVO DELETE JOB LOG amp DELJL JOBLOG DELETE STATUS amp JLDELS OUTPUT FILE amp SFILE END ASSIGN SYSDTA TO FILE PRIMARY ENDE END PROC 182 Sicherung und Reorganisation Sichern der Journale und Protokolle 4 2 Sichern der Journale und Protokolle und Ausgabe der Journalliste Sichern der Journals tze Die Journals tze eines Produktionszeitraums werden bei der Reorganisation gesichert Dabei werden die Journals tze aller Netze die sich im Status DELETED befinden in eine SAM Datei ausgegeben siehe auch Reorganisation der Dateien Das Format der S tze entspricht dem Format in der Not Journaldatei Die S tze sind in der SAM Datei nicht sortiert Um f r einen Produktionszeitraum eine vollst ndige und nach Netznamen sortierte Liste zu erhalten m ss
268. SHUTDOWN beendet den AVAS Server AVSRECV Die Eingabe erfolgt ber MODIFY JV JV IDENT2JV NAME jvname SHUTDOWN ab der ersten Stelle der berwachenden Jobvariable U21462 J Z125 7 485 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung 11 3 7 Prozess Server berwachung Damit das Starten der Server Jobs nur auf aktiven Servern durchgef hrt wird bietet AVAS eine Uberwachungsfunktion f r die in der Konfigurationsdatei eingetragenen Server Rea lisiert ist dies ber den Prozess Server berwachung Server Jobs die auf einem momentan nicht verf gbaren Server zum Ablauf gebracht wer den sollen erhalten den Status HOSTWAIT F r jeden in der Konfigurationsdatei eingetragenen Server ist unter der BS2000 Kennung der Ablaufsteuerung eine Jobvariable mit den Namen AVS SERVER STATE lt server jv link name gt lt server name gt anzulegen Diese AVAS Ser ver Jobvariable dient der Ablaufsteuerung zur Kontrolle der Betriebsbereitschaft eines Ser vers Das Aktualisieren der Server Kontrolljobvariablen wird ber den AVAS Prozess Ser ver berwachung realisiert Die Server Job Variable hat folgenden Inhalt Byte 1 2 Status des AVAS Servers U Undefined Der Zustand des Servers ist nicht bekannt Auftr ge f r diesen Rechner werden unbedingt gestartet R Running Der Server ist betriebsbereit und kann Auftr ge entgegenneh men Auftr ge f r diesen Rechner werden gestartet und erh
269. SIEMENS XMI Logging Programmname eines externen Management Tools AVASR3 Das Berechtigungsobjekt wird mit der mySAP com Transaktion SU03 gepflegt Administration gt Benutzerpflege gt Berechtigung Auswahl Basis Administration Berechtigung f r Externe Management Schnittstellen XMI S XMI ADMIN Werte einpflegen siehe oben 498 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Steuerung von SAP R 3 Jobs mit AVAS 11 5 5 Programmaufruf 11 5 5 1 Eingabe Parameter Folgende Parameter sind Pflicht Parameter f r das Programm avasr3 Parameter f r die ein Standardwert existiert m ssen nicht angegeben werden destination 32 CHAR Schl ssel DEST f r Datei saprfc ini user 16 CHAR Schl ssel USER f r Datei sapuser ini job 32 CHAR Name des mySAP com Jobs programx 8 CHAR bei mySAP com 3 1 40 CHAR bei mySAP com 4 0 internes ABAP 4 Programm f r Job Step x x 1 bis 9 oder 128 CHAR Name eines externen Programms eventuell mit vollst ndigem Pfad f r Job Step x x 1 bis 9 typx 6 CHAR intern extern intern ABAP 4 Programm Standard extern externes Programm Der folgende Parameter ist nur bei internen ABAP 4 Programmen zul ssig Er muss f r alle Programme angegeben werden die Selektionsbilder haben variantx 14 CHAR Variante f r programx in Job Step x Die folgenden Parameter sind nur bei externen Programmen zul ssig parameterx 128 CHAR Par
270. SSWORD 142 Reorganisationsanweisung 180 ZDL PASSWORD 143 Reorganisationsanweisung 181 U21462 J Z125 7 Stichw rter 560 U21462 J Z125 7 Ein einen Kurzbeschreibung des Produkts Zielgruppen des Handbuchs Verf gbare Dokumentation zu AVAS V7 0A iii Inhalt der AVAS Handb cher i Readme Datel nasser d nderungen gegen ber der vorigen Handbuchausgabe Hinweise zum Umstieg von AVAS V6 0A auf AVAS V7 0A Verwendete Metasprache ass a 9 9 NES aa aaa CA RACES NOR amp Installation und Generierung l l Installation des AVAS Systems BMASSSV e Wide siehe d EE CR E A Aen adeb eeh Edad a ia he aste ae dcn Dd d Versionsabh ngigkeiten in AVAS Konfigurationen EE AVROQUER EE E ENEE A A EE A Generierung des AVAS Systems i Verschl sselung der Kennw rter i Beschreibung der System Parameter Definitionen f r die zentralen Zugriffsprozesse Definitionen der Benutzer NEIE a sull R rin Definitionen der Systemvariablen der Benutzer Definieren der Ablaufsteuerung 2222220 rennen nn Definieren der Standardwerte f r Verarbeitungs Parameter Symbolische Namen der AVAS Anweisungen und Variablen ndern der System Parameter eines installierten AVAS Systems Erstellen der Generierungs Parameter aus den System Parametern Syntax der Generierungsanweisung und Erste
271. SYS 163 Hypernetz 530 U21462 J Z125 7 JVCENTRAL 22 JV Datei 454 JVPLAMZD 22 JVUPAMZD 22 K Kalender 3 Kalenderbibliothek CALLIB 54 Kennwortvergabe Ablaufsteuerung 114 Kennwortverschl sselung 19 Kommando REMARK UID 264 Kommunikationsbereich Assembler Schnittstelle definieren 0 Cobol Schnittstelle definieren 427 RZ Exits 80 Kommunikationsbereich COMAREA 380 Kommunikationskennwort comm pw 454 460 Konfiguration AVAS DOORS 65 mySAP com Zugriff 496 Konfigurationsdatei 533 Bereiche f r Eingabe 459 Besipiel 462 editieren 462 erstellen 520 Server System 459 Konfigurationsdaten als DEFAULT Parameter 454 Kontrollanweisung NETC 35 kontrollieren Server Job 518 Kontrolljobvariablen SV JV 121 Kopf Ergebnisbereich definieren 404 430 Kopplung AVAS mit MAREN 259 K Tasten definieren 37 L LATEST START 533 Lesezugriff Journaldatei 376 LIFE TIME 533 Linknamen AVAS QUER 17 233 Liste LO6001 307 LO6002 308 Literaturhinweise 11 U21462 J Z125 7 Stichw rter JOBLOG DELETE STATUS Reorganisationsanweisung 177 JOBLOG Protokoll EDT Prozedur 106 JOBLOG Satz Protokoll 138 JOBLOG SAVE LINK Reorganisationsanweisung 178 JOBLOG SAVE OPTION Reorganisationsanweisung 177 JOBMAP 54 2 JOB PARAMETER 532 JOB STATUS 532 Job Steuersatz 2 JOB TEXT 532 JOB TYPE 532 Jobvariable Batch Prozesse berwachen 133 eingeben in 127 Prozesse berwachen 133 Schnittstelle 443 Server Job 9 Journaldatei 532 Dateiname 6 form
272. Schnittstelle Der Cobol Aufruf wird im Benutzerprogramm durchgef hrt CALL AVASBCOB USING AVASBCOM Kommuni kationsbereich AVASBOUT Ergebnisbereich AVASBWRK Arbeitsbereich 2 Programm bersetzen F r die bersetzung eines Cobol Programms mit AVAS Parameterstrukturen ist die Zu weisung der Bibliothek mit den COPY Elementen erforderlich Die Zuweisung kann mit folgendem BS2000 Kommando erfolgen ADD FILE LINK LINK NAME COBLIB FILE NAME SYSSRC AVAS 070 3 Programm binden Der AVAS Schnittstellenmodul AVSBCALL ist aus der Bibliothek SYSLNK AVAS 070 fest zum Hauptprogramm hinzuzubinden 4 Programm starten Beim ersten Aufruf aus dem Benutzerprogramm an AVAS l dt der AVAS Schnittstellen modul weitere Module nach Der Ladeaufruf erfolgt unter Angabe des Bibliothek namens SYSLNK AVAS 070 Wenn die AVAS Module nicht in der Bibliothek mit dem Namen zur Verf gung stehen oder wenn die AVAS Bibliothek in einem anderen Pubset abgelegt ist kann vor dem Programmstart eine Zuweisung mit folgendem BS2000 Kommando erfolgen SET FILE LINK LINK NAME SYSLNK FILE NAME lt catid gt lt userid gt SYSLNK AVAS 070 5 Schnittstellenbereiche Die Bereiche der Schnittstellen werden durch COPY Elemente beschrieben AVSCOBBQ Schl sselwerte AVSCOBBC Verst ndigungsbereich AVSCOBBO Ergebnisbereich AVSCOBRT funktionsspezifischer Ergebnisbereich AVSCOBBW Arbeitsbereich AVSCOBJD Netzverzeichniseintrag Journaldatei AVSCOBJN Net
273. Standardwert nicht ber cksichtigt Die Einstellm glichkeit gilt nicht f r die DELETE Anweisungen Hier m ssen in jedem Fall die Objekte markiert werden die gel scht werden sollen Definition von Standardwerten f r die Netzbeschreibung Wenn ein Standardwert nicht beschrieben wird wird der unterstrichene Wert angenom men DEFAULT NET TYPE 2 1 2 3 Standardwert f r den Parameter NET TYPE in der Maske AVNOO1 DEFAULT NET DELAY WAIT START IGNORE CANCEL Standardwert f r den Parameter NET DELAY SOLUTION in der Maske AVNO2O DEFAULT NET TURNUS 1 2 3 4 5 6 7 8 9 Standardwert f r den Parameter SELECT TURNUS in der Maske AVNO2O DEFAULT PLAN TYPE WORK NWRK Standardwert f r den Parameter SELECT PLAN TYPE in der Maske AVNO20 DEFAULT DOC NAME NONE STD Standardwert f r den Parameter NET DOC JOB DOC COND DCC in den Masken AVNOO1 AVNOO2 AVNOOS AVNOO8 AVNOO09 AVNO30 AVNO31 und AVNO32 DEFAULT USER PARFILE NONE STD Standardwert f r den Parameter USER PAR FILE in der Maske AVNOO1 DEFAULT JOB TURNUS 0 1 2 3 4 5 6 7 8 9 Standardwert f r den Parameter SELECT TURNUS in den Masken der Planungsdaten f r Strukturelemente DEFAULT JOB TYPE MOD STD EXT Standardwert f r den Parameter JOB TYPE in der Maske AVNOOA 38 U21462 J Z125 7 Installation und Generierung Generierung des AVAS Systems DEFAULT ENTER PARAMSS NET LOGON Standardwert f r den Parameter ENTER PARAMS
274. T NAME muss angegeben werden der Parameterwert kann teilqualifi ziert angegeben werden Der Parameter INDEX ist nur in Verbindung mit einem vollqualifizierten Netznamen zuge lassen Wenn der Parameter INDEX angegeben wird wird f r diese Indexstufe der HOLD Zustand gesetzt Der Parameter PERIOD NAME ist nur in Verbindung mit einem teilqualifizierten Netzna men zugelassen Wenn der Parameter RUN CONTROL SYSTEM nicht angegeben wird wird der Name der Ablaufsteuerung ber die Anmeldedaten ermittelt Protokoll der Verarbeitung F r jedes unterbrochene Netz wird AVS8521 HOLD NET netname RESULT ergebnis ausgegeben oder eine Fehlermeldung U21462 J Z125 7 HOLD NET 334 BATCH Anweisungen MODIFY COND DESCRIPTION MODIFY COND DESCRIPTION ndern eines Bedingungseintrags Mit MODIFY COND DESCRIPTION k nnen bereits vorhandene Bedingungseintr ge der Typen NET JOB RES und VAL ge ndert werden Der Parameter COND NAME muss angegeben werden der Parameterwert muss vollqua lifiziert angegeben werden Der Parameter TYPE muss angegeben werden da die Verarbeitung vom Bedingungstyp abh ngt F r die unterschiedlichen Bedingungstypen sind folgende Parameter zugelassen e TYPE NET MODIFY COND DESCRIPTION COND NAMES bk_ condname TYPE NET COND VALUEstatus LIFE TIME tt mm jj hh mm ss CREATED BY NET bk netname date time Mindestens einer der Parameter LIFE TIME oder COND VALUE muss angegeben wer den
275. TARBEIT ERIOD START DATE 0 0 ERIOD END DATE 0 0 UU UU rm U21462 J Z125 7 321 CREATE PERIOD BATCH Anweisungen HEUTE RESTARBEIT von der aktuellen Uhrzeit des laufenden Tages bis 23 59 Uhr des Tages PERIOD NAME MORGEN PERIOD START DATE 1 0 PERIOD END DATE 1 0 MORGEN von 00 00 Uhr bis 23 59 Uhr des folgenden Tages PERIOD NAME WOCHE PERIOD START DATE 7 1 PERIOD START TIME 21 00 PERIOD END DATE 7 0 PERIOD END TIME 20 59 WOCHE von Sonntag letzter Woche bis Sonntag der laufenden Woche PERIOD NAME ULTIMO PERIOD START DATE 0 PERIOD END DATE 0 ULTIMO der letzte Tag des laufenden Monats von 00 00 bis 23 59 Wenn der Tag auf einen Samstag oder Sonntag f llt wird der vorausgehende Freitag angenommen PERIOD NAME ULTIMO LANG PERIOD START DATE 0 PERIOD END DATE 0 ULTIMO LANG der letzte Tag des laufenden Monats von 00 00 bis 23 59 Wenn der Tag auf einen Samstag oder Sonntag f llt beinhaltet ULTIMO die Tage Freitag und Samstag und Sonntag Hinweise e Die Namen sowie die Start und Endezeiten der Perioden kann der Anwender festlegen siehe Handbuch AVAS Funktionen 2 Wenn ein Datum variabel angegeben wird PERIOD START DATE oder PERIOD END DATE muss auch das andere Datum variabel angegeben werden Bei der Definition eigener variabler Perioden ist zu beachten dass PERIOD START DATE und PERIOD END DATE stets ein
276. TION DELETE PERIOD DELETE PLAN NET DELETE PROD JOB END HOLD NET MODIFY COND DESCRIPTION REPEAT NET RESTART NET RESUME NET SIGNON SUBMIT NET Alle anderen AVAS Funktionen werden als unbekannte Funktionen zur ckgewiesen Bei der Verarbeitung der BATCH Anweisungen werden alle Meldungen die einen Fehler anzeigen nach SYSOUT ausgegeben Abh ngig vom Meldungsgewicht wird ein Auftrags U21462 J Z125 7 schalter gesetzt siehe Seite 345 312 BATCH Anweisungen ADD JOB LOG 8 1 BATCH Anweisungen BATCH Anweisungen und ihre Parameter d rfen jeweils in nur einer Eingabezeile angege ben werden Damit ergibt sich der folgende syntaktische Aufbau anweisungsname operand wert operand wert Nach dem Namen der BATCH Anweisung und nach den Parameterangaben kann ein Kom ma angegeben werden Die BATCH Anweisungen m ssen nicht auf der ersten Stelle eines Eingabesatzes begin nen Angaben ohne werden als BATCH Anweisung interpretiert Ein Stern an der ersten Stelle eines Eingabesatzes wird als Kommentaranweisung ange sehen Der Satz wird nicht verarbeitet ADD JOB LOG Hinzuf gen von Protokolldaten Mit ADD JOB LOG k nnen Protokolle dort hinzugef gt werden wo der Protokolleintrag den Status CREATED ASSIGNED ERROR oder ADDED hat Wenn beim BATCH Aufruf nur der Netzname angegeben wird werden nur Protokolleintr ge mit dem Status ASSIGNED und ERROR bearbeitet ADD JOB LOG NET NAME S bk netname CATI
277. TO FILE SYSCMD START PROG FROM FILE PHASECLIB 8USERID SYSPRG AVAS 070 SYSTEM ELEMENT AVAS SYS LOAD REPORT REPORT NAME PLANNED NET MODIFICATION FUNKTIO ALL AVAS SYTEM ID RAVSYID SYSTEM PASSWORD RAVSYPW AVAS USER ID amp AVSUSID USER PASSWORD RAVUSPW NET NAME ALL OUTPUT WORK FILE AVAS WORK REPORT amp REPORT SORT FIELDS ORDER NET NAME OUTPUT REPORT FILE AVAS FILE REPORT amp REPORT END ASSIGN SYSDTA TO FILE PRIMARY SHOW FILE ATTR FILE NAME AVAS FILE REPORT amp REPORT WRITE TEXT TEXT2 FILE AVAS FILE REPORT amp REPORT ERSTELLT SKIP COM REP END SET JOB STEP ABEND CANCEL PROC REP PNM REMARK gt END REPORT END PROC 310 U21462 J Z125 7 8 BATCH Funktionen H ufig wiederkehrende Aufgaben der AVAS Steuerung k nnen auch prozedural abgewi ckelt werden Dazu stehen f r eine Reihe von AVAS Dialogfunktionen entsprechende batchf hige Anweisungen zur Verf gung Analog dem AVAS Dialogsystem kann ein Prozess geladen werden der BATCH Anweisun gen ber die BS2000 Systemdatei SYSDTA einliest und das Ergebnis ber die System datei SYSOUT protokolliert Der Batch Prozess meldet sich bei AVAS wie der Dialog Prozess an siehe Handbuch AVAS Anweisungen 1 d h mit den SIGNON Daten AVAS USER ID PASSWORD und AVAS SYSTEM ID Alle Meldungen im Zusammenhang mit einer BATCH Funktion entsprechen den Meldun gen i
278. UNIX und LINUX Die Software von AVAS SV wird auf diesen Plattformen ausschlieBlich durch uninstall avs deinstalliert e IBMAIX Mounten Sie die CD mit dem Kommando mount v cdrfs o ro device lt mountpoint gt f r device z B dev cd0 f r lt mountpoint gt z B cdrom e HP UX V10 V11 Mounten Sie die CD mit dem Kommando mount o cdcase device lt mountpoint gt f r device z B dev dsk c0t4d0 f r lt mountpoint gt z B cdrom UnixWare Mounten Sie die CD mit dem Kommando mount F cdfs r lt device gt lt mountpoint gt f r device z B dev cdrom c1b0t510 f r lt mountpoint gt z B CR ROM_1 Tru64 UNIX Mounten Sie die CD mit dem Kommando mount r lt device gt lt mountpoint gt f r device z B dev cd0 f r lt mountpoint gt z B cdrom e SuSE LINUX 7 0 auf Intel Plattform Mounten Sie die CD mit dem Kommando mount lt device gt lt mountpoint gt f r device z B dev cdrom f r lt mountpoint gt z B cdrom Die Benutzerkennung unter der sh MountPunkt uninstall avs gestartet wird muss die der Installation sein Wenn dies die Kennung 7001 ist wird nach der Benutzerkennung der aktuellen AVAS Installation gefragt Es wird gepr ft ob AVAS SV unter dieser Kennung installiert ist und wenn vorhanden die Deinstallation durchgegeben Nach dem Best tigen der Deinstallation werden die entsprechenden Produktdateien und Verzeichnisse gel scht Da Anwender bzw
279. UTPUT WORK LINK ein BS2000 Dateikettungsname zugeord net Die Arbeitsdatei ist e die Ausgabedatei bei FUNKTION CREATE e die Ein Ausgabedatei bei FUNKTION SORT e die Eingabedatei bei FUNKTION PRINT Die Arbeitsdatei muss bei allen Funktionen zugeordnet werden OUTPUT WORK LINK full filename Kettungsname gem den BS2000 Konventionen Die ber die Anweisung OUTPUT WORK LINK zugeordnete Arbeitsdatei wird vom REPORT Generator im Modus OUTPUTZEXTEND er ffnet wenn sie bereits vorhanden ist Der REPORT Generator sammelt die Daten der Netze in der angegebenen Arbeitsdatei wenn FUNKTION CREATE mehrfach mit der gleichen Dateizuweisung aufgerufen wird Wenn eine neue Arbeitsdatei angelegt werden soll muss eine u U vorhandene Arbeits datei vorher gel scht werden Der Kettungsname muss ber das BS2000 Kommando SET FILE LINK definiert werden Die Anweisung OUTPUT WORK LINK kann alternativ zur Anweisung OUTPUT WORK FILE angegeben werden U21462 J Z125 7 295 PERIOD NAME REPORT NAME REPORT Anweisungen PERIOD NAME Ausw hlen Netze ber das Startdatum PLAN START Mit PERIOD NAME werden die Netze aus dem Produktionsplan ber das Startdatum PLAN START ausgew hlt die in die Arbeitsdatei OUTPUT WORK FILE bertragen wer den sollen PERIOD NAME period tt mm jj hh mm ss tt mm jj hh mm ss PERIOD NAME period Symbolischer Name einer gespeicherten Periode PERIOD NAME tt mm jj hh mm ss Reale Datums und Zeita
280. VALUE muss angegeben werden damit eine Verarbeitung durchgef hrt werden kann e TYPE VAL MODIFY COND DESCRIPTION COND NAMES bk_ condname TYPE VAL COND VALUES pos value pos Anfangsposition f r Wertangabe 1 128 value Wertangabe c string C c string X x string Der Parameter COND VALUE muss angegeben werden damit eine Verarbeitung durchgef hrt werden kann F r die Beschreibung pos value stehen maximal 74 Stellen zur Verf gung Sollen mehr als 74 Stellen von COND VALUE ge ndert werden muss die BATCH Anweisung MODIFY COND DESCRIPTION mehrfach angegeben werden Bei Ausf hrung der Anweisung wird die nderung beim Bedingungseintrag ab der vor gegebenen Position mit dem angebenen Wert durchgef hrt Hinweise e Der Bedingungseintrag muss ber die Parameter eindeutig zu identifizieren sein sonst wird die Verarbeitung mit einer Meldung abgewiesen e Bei TYPE NET JOB RES kann unter COND VALUE ein zul ssiger Statuswert an gegeben werden der bei der Maske AVDOSO Parameterfeld COND VALUE beschrie ben ist siehe Anweisung MODIFY COND DESCRIPTION im Handbuch AVAS Anwei sungen 1 336 U21462 J Z125 7 BATCH Anweisungen MODIFY COND DESCRIPTION e Bei TYPE VAL kann COND VALUE nur mit einer Wertangabe in der Form COND VALUE pos value vorgegeben werden e Der Parameter LIFE TIME entspricht dem Wert im Parameterfeld LIFE TIME der Mas ke 0 Protokoll der Verarbeitung F r den bearbe
281. VSOTAB DS 0C 404 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Schnittstelle AVSASSBW Arbeitsbereich definieren Parameter MF C D PREFIX A char 1 lt MACID VSW char 3 gt COUNT 0 integer 0 999 gt MSGTAB YES NO ONLY und PREFIX siehe AVSASSAD auf Seite 389 Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Standardwert VSW Beschreibt die Gr e einer Tabelle In diesen Bereich werden Meldungen die bei der Bearbeitung einer Anweisung auftreten in tabellarischer Form abgelegt 999 Anzahl der Tabellensegmente COUNT O zeigt an dass kein Bereich defi niert reserviert werden soll Steuert den Umfang der Markoaufl sung Es werden der Tabellenkopf der Bereich f r die Tabelleneintr ge und die Beschreibung der Tabelleneintr ge generiert Es werden nur der Tabellenkopf und der Bereich f r die Tabelleneintr ge generiert Es wird nur ein Tabelleneintrag generiert 405 Makro AVSASSBW Parameter MF MACID COUNT integer O MSGTAB YES NO ONLY U21462 J Z125 7 Assembler Schnittstelle Programmschnittstelle von AVAS Aufl sung des Makros AVSASSBW AVSASSB MFCHK MF C PRFIX A MACID VSW DMACID VSW SUPPORT C D DS OF H PREFIX A MACID VSW 4HHHE AVAS BATCH PROGRAM INTERFACE WOR
282. X A char 1 gt MACID VSN char 3 gt EQU NO YES Parameter MF und PREFIX siehe AVSASSAD auf Seite 389 MACID Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Standardwert VSN EQU Steuert die Generierung von Equates f r die Schl sselfelder N Es werden keine Equates generiert YES Es werden Equates generiert Hinweis Der Makro AVSASSAN generiert eine Verl ngerung des Ausgabebereichs Er muss daher im Anschluss an den Makro AVSASSBO aufgerufen werden Aufl sung des Makros AVSASSAN AVSASSAN MFCHK MF C PREFIX A MACID VSN DMACID VSN SUPPORT C D DS OF AHHHHE PREFIX A MACID VSN HHHH 4 ABLDAT NET DESCRIPTION AVSNANET DS 0CL512 AVSNFNAM DS 22050 FUNCTION NAME AVSNCNAM DS 0CL32 COND NAME AVSNSNNM DS 0CL32 SUBNET NAME AVSNJNAM DS CL30 JOB NAME DS 002 AVSNIND DS 03 FUNCTION INDEX AVSNSIND DS CL3 START INDEX AVSNSYN DS 03 FUNCTION SYNC INDEX U21462 J Z125 7 393 Assembler Schnittstelle Programmschnittstelle von AVAS AVSNSTT DS X FUNCTION STATE 1 AVSNST2 DS X FUNCTION STATE 2 AVSNST3 DS X STATE NO PLAN NO SUBMIT IGNORE DELETED AVSNSTTS DS X SAVE STATE FOR HOLD IN STT AVSNENDG DS CL2 END CONDITION JOB PROC AVSNFUNC DS CLI FUNCTION AVSNTYPE DS X TYPE AVSNRSRV DS CLI
283. X SERIAL WAIT t wait Mit MAX SERIAL WAIT wird die maximale Zeit festgelegt die ein Benutzer bei der Ver arbeitung eines Netzes warten muss wenn er eine Serialisierung belegen will U21462 J Z125 7 110 Administration von AVAS Starten und Beenden der AVAS Prozesse Wenn ein Benutzer bei der Bearbeitung eines Netzes auf die Belegung eines Serialisie rungsbegriffes l nger warten muss als mit MAX SERIAL WAIT vorgegeben wurde wird die Verarbeitung des Netzes abgebrochen Bei der bersichtsverarbeitung mit Markierung Y N wird Result ERROR f r das Netz angezeigt Bei der Einzelverarbeitung vollqualifizierter Parameter NET NAME oder Markierung S in der Netz bersicht wird eine Meldung ausgegeben Wenn eine serialisierte Anweisung gleichzeitig von mehreren Benutzern abgesetzt wird muss der Wert f r t wait auch ein mehrfaches von t lock sein Als sinnvolle Zeitangabe wird empfohlen t wait t lock maximale Bearbeitungszeit Anweisung Maske Operation Bemerkung CREATE ORDER EXECUTE bersichtsverarbeitung mit Markierung Y N AVPO12 Die Serialisierung wird f r jedes ausgew hlte Netz CREATE PLAN NET gesetzt und nach dem Ende der Netzbearbeitung zur ck AVPO11 gesetzt Wenn die Serialisierung nicht belegt werden kann MAX SERIAL WAIT wird Result ERROR f r das CREATE PROD NET Netz gesetzt Die Verarbeitung wird mit dem n chsten AVMO12 ausgew hlten Netz fortgesetzt SUBMIT NET AVFO001 CREATE PLAN NET SAVE b
284. YSLNK AVAS 070 zugeordnet werden 74 U21462 J Z125 7 RZ Exits im AVAS System Installation und Generierung Die Bindemodule AVOSEXIT AVOAEXIT und AVOGEXIT ohne RZ Exit werden in der Systembibliothek SYSLNK AVAS 070 ausgeliefert Sie m ssen gel scht werden wenn eigene AV EXIT Module mit RZ Routinen genutzt werden sollen Hinweise e Die ausgelieferten Bindemodule sollten vor dem L schen sichergestellt werden e n den RZ Routinen sollten keine Aufrufe zur Beendigung des Prozesses z B TERM programmiert werden Die Verwendung eines eigenen STXIT Mechanismus ist erlaubt AVAS setzt die STXIT Parameter nach jeder R ckkehr wieder auf eigene Werte AVOGEXIT REORG 75 Zuordnung der RZ Exits zum EXIT Modul AVOAEXIT AVAK ja AVOSEXIT DIALOG BATCH RZ Exit AVEXO0001 bzw AVEX0002 AVEX0101 AVEX0102 AVEX0401 AVEX0402 AVEX0403 AVEX2001 AVEX6601 AVEX6602 AVEX6801 AVEX6802 AVEX7101 AVEX7102 U21462 J Z125 7 RZ Exits im AVAS System Installation und Generierung Registerkonventionen In den Registern 1 13 14 und 15 bergibt AVAS Adressen mit folgendem Inhalt an die RZ Routinen Register 1 Adresse einer Parameter Adressleiste zwei Worte 1 Wort Adresse des Verst ndigungsbereichs 2 Wort Adresse des Kommunikationsbereichs Register 13 Adresse des Register Sicherstellungsbereichs 18 Worte Register 14 Adresse f r den R cksprung zu AVAS Register 15
285. YSPRC AVAS 070 der Generierungslauf gestartet werden Dadurch werden aus den Generierungs Parametern die AVAS System Parameter erzeugt und in der ISAM Datei mit dem Standardnamen AVAS USER SYSPAR gespeichert Die Ablaufdatei und die Journaldatei m ssen vor der Verwendung im AVAS System mit der Prozedur AVS FORM Element in der Bibliothek SYSPRC AVAS 070 formatiert werden Einige System Parameter k nnen auch im laufenden AVAS Betrieb ge ndert werden Welche Werte ge ndert werden k nnen ist bei den einzelnen Parametern angegeben Wenn die System Parameter mit der Anweisung MODIFY SYSTEM PARAMS ge ndert werden bleiben die zugeh rigen Generierungs Parameter in der Generierungsdatei unver ndert 2 2 4 Verschl sselung der Kennworter Die Kennw rter der AVAS Benutzer und die Kennw rter in den AVAS Prozeduren werden standardm ig verschl sselt Die Verschl sselung der Kennw rter der AVAS Benutzer erfolgt bei der Generierung bei der Eingabe ber die Anmeldemaske und bei der Eingabe ber die Anweisung MODIFY SYSTEM PARAMS Die Kennw rter in den AVAS Prozeduren zur Anmeldung bei den zentralen Zugriffsprozes sen werden jeweils in den zugeordneten Programmen verschl sselt Die Verschl sselung der BS2000 Kennw rter in den Netzen kann ber den AVAS Generie rungs Parameter PASSWORD ENCRYPTION eingestellt werden In den Netzen sind folgende Kennw rter gespeichert NET PASSWORD JOB PASSWORD JVA PASSWORD und FILE PASSWORD Di
286. Z NN3L U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen Externe Erstellung von AVAS Elementen AVASNET RECORD NA4 PREFIX N EQU YES MFCHK MF C 8 PREFIX N C MACID MA C DMACID NAD C SUPPORT C D DS OF BERN PREFIX N MACID NA GHHHHE NN4A DS OF NNASLEN DS H PLAM RECORD LENGTH DS 0 PLAM RESERVED PLAM SK DS PLAM RESERVED PLAM SA NNASSL DS 602 RECORD KEY DS CL RESERVED DS CL RESERVED DS CL RESERVED NNAIND DS CL3 ET INDEX 000 NNANAM DS CL18 ET NAME DS CL14 RESERVED ET PARAMETERS ACFST DS X CHECK ERROR STATE 4EQFN EQU X 00 NO CHECK NET VERS gt V 1 3A 4EQFO EQU X O1 NO ERROR 42081 EQU X 02 ERR ST 1 WARNING 4EQF2 EQU X 04 ERR ST 2 WARNING BY RESTART NET 4EQF3 EQU X 10 ERR ST 3 MODIFY BY SUBMIT NET 4EQF4 EQU Xx 20 ERR ST 4 ERROR RESULT NO PLAN ACCMD DS X CMD OF LAST CHEC 4EQ00 EQU 0 NO CHECK NET VERS gt V 1 3A 4EQ41 EQU 41 CREATE NET DESCRIPTION 4EQ42 EQU 42 MODIFY NET DESCRIPTION 4EQ55 EQU 55 COPY ELEMENT 4EQ60 EQU 60 ADD PLAN NET ONLY NPRLIB ANTYP DS C ET TYPE DS C RESERVED ARCSY DS CL8 RUN CONTROL SYSTEM ANUSE DS CL8 ET USER ENTER USER ID ANACC DS CL8 ET ACCOUNT ENTER ACC NUMBER ANCLA DS CL8 ET CLASS ENTER JOB CLASS ANLGM DS CL8 ET LOG ANPAS DS CL19 ET PASSWORD ANPAR DS CL128 ET PARAMETER ANCAT DS 0CL54 ET
287. Z125 7 159 Administrationsaufgaben im Betrieb Administration von AVAS Um Warteschlangen zu vermeiden ist den Zugriffsprozessen eine wesentlich h here Prio ritat zuzuweisen als den Abl ufen mit AVAS BATCH Anweisungen Ebenso ist der ZDD Prozess mit h herer Priorit t zu betreiben als der ZDL Prozess ber den ZDD Prozess werden bei den kritischen Anweisungen etwa doppelt so viele Zugriffe abgewickelt als ber den ZDL Prozess Beispiel AVAS BATCH PRIO 255 Ablaufsteuerung PRIO 250 AVAS Dialog PRIO 240 CENTRAL PRIO 220 ZDL PLAM PRIO 220 ZDD UPAM PRIO 200 Bei der Formatierung der Ablaufdatei ABLDAT und der Journaldatei JRNDAT ist die mittel fristig maximal erforderliche Dateigr e vorzugeben und zu formatieren Dadurch werden Dateierweiterungen im laufenden Betrieb vermieden Bei einer Dateierweiterung m ssen die neuen Bl cke gelesen formatiert geschrieben und in die Kette der freien Bl cke eingekettet werden W hrend dieser Zeit ist die Datei gesperrt Organisatorische Ma nahmen Die AVAS Netze und Jobs werden bis zur Produktionsfreigabe ber SUBMIT NET in PLAM Bibliotheken gespeichert Bei der Bearbeitung von Netzen und Jobs wird jeweils das zu bearbeitende Element in der Bibliothek gesperrt Journals tze f r ein Netz werden erstmalig bei der Anweisung CREATE PLAN NET aus gegeben wenn das geplante Netz in den Produktionsplan NPRLIB eingetragen wird Alle nachfolgenden Funktionen mit denen ein Netz im
288. ZE VON DATEI1 NACH DATEI2 START PROGRAM FROM FILE PERCON SELECT COND END REMARK LOESCHEN KATALOGEINTRAG VON DATEI2 EXPORT FILE FILE NAME DATEI2 LOGOFF Beispiel f r Job 2 SET LOGON PARAMETERS REMARK ZUWEISEN DER IM 1 JOB ERSTELLTEN BANDDATEI REMARK ZUWEISEN EINER PLATTEN EINGABEDATEI IMPORT FILE SUPPORT TAPE VOLUME VOL DEVICE TYPE T6250 FILE NAME DATEI2 SET FILE LINK LINK NAME INPUTl FILE NAME DATEI2 SET FILE LINK LINK NAME INPUT2 FILE NAME DATEIS3 REMARK ZUWEISEN EINER PLATTEN AUSGABEDATEI SET FILE LINK LINK NAME OUTPUT FILE NAME DATEIA4 START PROGRAM FROM FILE PROG2 m m rm rm REMARK LOESCHEN KATALOGEINTRAG VON DATEI2 EXPORT FILE FILE NAME DATEI2 LOGOFF U21462 J Z125 7 276 Erstellen von Datentr gerlisten Wenn ein derartig aufgebautes Netz ber REPEAT NET wiederholt werden soll sind keine besonderen Aktionen notwendig Es ist sinnvoll den im vorausgegangenen Ablauf des Net zes erstellten Datentr ger freizugeben falls er nicht mehr ben tigt wird MAREN Anwei sung MOD VOL ATTR VOL vsn FREE DATE 0 EXPIR DATE 0 und damit auch die fehler hafte Version dieser Datei aus dem MAREN Katalog zu entfernen 6 3 7 Fehlermeldungen von MARENAV Im Fehlerfall bergibt MARENAV zu Diagnosezwecken den Meldungsschl ssel der MAREN Meldung und eventuell die VSN bei der der Fehler auftrat Gibt es f
289. a pridest pricopi LOG Datei BS2EXT PRI Y 10g 30 d No Text Job wurde gestartet Step 001 gestartet Externes Programm 1s Zugeh Parameter x Ext Prog ENQLOGOO 516 611 612 613 606 606 Ext se sapBA0_DVEBMGSOO 606 Ext Prog sapstart3 trc Prog se sapB40_DVEBMGSO1 507 version 1 8 Time 501 9 114906 0 9 114906 BT 9 114906 BT 9 114906 BT 9 114907 BT 9 114907 t4 trc 9 114907 AVASR3 Job log Date 2004090 2004090 2004090 2004090 2004090 2004090 sapstar 2004090 U21462 J Z125 7 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung shutdown sap stderrl 20040909 114907 BT 606 Ext Prog stderr2 stderr3 stderr4 20040909 114907 BT 606 Ext Prog stdoutl stdout2 stdout3 20040909 114907 BT 606 Ext Prog stdout4 20040909 114907 00 550 Step 002 gestartet Programm RSPFPAR Variante GW Benutzername EICH 20040909 114908 BT 611 Step 003 gestartet 20040909 114908 BT 612 Externes Programm pwd 20040909 114908 BT 613 Zugeh Parameter 20040909 114908 BT 606 Ext Prog usr sap B40 DVEBMGSO1 work 20040909 114908 BT 607 Job wurde beendet Ausgaben von externen Programmen auf deren Beendigung der Job wartet werden ins Job Protokoll bernommen 508 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Steuerung von SAP R 3 Jobs mit AVAS 11 5 6 2 Windows Plattformen Standalone Wind
290. a bp 10 lt 10 pp Anzahl der permanent angemeldeten Programme an der Programm schnittstelle z B RZ Monitor bp Anzahl der BATCH Prozesse zur Produktionsplanung die parallel ablaufen sollen F r bp ist ein Wert zwischen 0 und 3 einzusetzen 0 keine Produktionsplanung ber BATCH Prozesse 3 permanente zyklische Produktionsplanung ber BATCH Prozesse ba Anzahl der sonstigen verwendeten BATCH Jobs zur Auswertung und Anderung der AVAS Datenbest nde die im Zusammenhang mit der Produktionsplanung zum Ablauf gebracht werden Ein Wert gr er 3 f r bp ist nicht sinnvoll weil die Anweisungen CREATE PLAN NET CREATE PROD NET und SUBMIT NET serialisiert werden und der 4 Prozess immer auf die Serialisierung warten muss Wenn die Produktionsvorbereitung nicht ber CREATE PROD NET abgewickelt wird ist der gr te sinnvolle Wert f r bp der Wert 2 23 U21462 J Z125 7 Generierung des AVAS Systems Installation und Generierung Beispiel pp 1 RZ Monitor ber AVAS Prog SS bp 2 permanente Produktionsplanung ba 4 COPY ELEMENT CREATE PERIOD HOLD NET RESUME NET RESTART NE M B P 1 2 2 2 4 10 4 MSG7 DEST DIALOG SYSOUT SYSLST BOTH Mit dem Parameter MSG7 DEST DIALOG wird vorgegeben wohin die Meldungsausgabe ber die MSG7 Schnittstelle erfolgen soll SYSOUT Ausgabe erfolgt nur nach SYSOUT Standardeinstellung SYSLST Ausgabe erfolgt nur nach SYSLST BOTH Ausgabe erfolgt nach SYSOUT und SYSLST
291. als BS2000 ISAM Datei mit einem Editor EDT erstellt und aktualisiert AVSSINCM der AVAS Agent im BS2000 OSD muss Zugriff auf die Konfigurationsdatei haben Wenn AVSSINOM in verschiedenen Kennungen gestartet werden soll muss in jeder Ken nung eine Konfigurationsdatei vorhanden sein oder der Zugriff auf eine mehrbenutzbare Datei gew hrt werden F r jeden AVAS Server zu dem AVSSINCM eine Verbindung aufbauen soll muss ein Ein trag in der Konfigurationsdatei angelegt werden Dieser Konfigurationseintrag enth lt die Angaben die im Server System gebraucht werden um eine Datei abzulegen und zu star ten Es wird vorgeschlagen die Konfigurationsdatei in der AVAS Kennung in der die Ab laufsteuerung l uft abzulegen und mit READ PASS gegen unbefugten Zugriff zu sch tzen Aufbau eines Eintrags der Konfigurationsdatei lt server name gt lt server pw gt lt hostname portnr gt lt userid gt lt comm pw gt dir lt pfad gt server name Symbolische Bezeichnung einer Server Benutzerkennung L nge 8 Byte ggf mit Leerzeichen auff llen Die Bezeichnung muss in Gro buchstaben angegeben werden und in Spalte 1 beginnen Die symbolische Bezeichnung einer Server Benutzerkennung wird im Feld SERVER NAME der Maske AVNO009 eingegeben server pw Kennwort der symbolischen Bezeichnung der Server Benutzer kennung oder NONE Lange maximal 8 Byte Das vorgegebene Kennwort ist die Zugriffsberechtigung auf server name und somit das Nutzu
292. alt 25 02 Datensatz mit dem neuen Inhalt Die JCL Anweisung soll nicht in die Ablaufdatei bernommen werden Ins Journal wird ein Satz eingetragen 25 04 Datensatz mit altem Inhalt 101 EQU X 00 EQU X 02 EQU X 08 EQU X 12 EQU X 14 pfixOK pfixUPD pfixABE pfixUIN pfixUDE U21462 J Z125 7 RZ Exits im AVAS System Installation und Generierung Hinweise e F r S Prozeduren werden der RZ Routine neben den Prozeduranweisungen auch die AVAS Prozedur Parameter bergeben Die Parameter sind von den Prozeduranwei sungen durch das Trennzeichen AVAS PROC PAR oder die bei der Generierung vorgegebene Zeichenfolge getrennt Wenn das Trennzeichen gel scht wird kann AVAS die Parameter nicht mehr erkennen und setzt den ENTER PROC Aufruf ohne Prozedur Parameter ab e F r Server Jobs werden der RZ Routine neben den Script Anweisungen auch die Parameter bergeben Die Parameter sind vom Server Script durch das Trennzeichen ANAS SINIX PAR oder die bei der Generierung vorgegebene Zeichenfolge getrennt Wenn das Trennzeichen gel scht wird kann AVAS die Parameter nicht mehr erkennen und startet den Server Job ohne die Parameter zu verwenden e Wenn die RZ Routine andere Returncodes zur ckmeldet setzt AVAS im Feld MSG RESULT eine Fehlermeldung ab die Netzfreigabe wird nicht durchgef hrt e Bei R ckgabe von JCL Anweisungen an AVAS darf die L nge von 256 Zeichen nicht berschritten werd
293. alten den Sta tus RUNNING T Terminated Die Server berwachung oder das Programm AVSSINCM konnten keine Verbindung zu dem Server herstellen Der Server ist nicht betriebsbereit oder ber das Netz nicht erreichbar Auftr ge k nnen nicht entgegengenommen werden Auftr ge f r diesen Rechner erhalten den Status HOSTWAIT D Deleted Der Server ist nicht in der Konfigurationsdatei enthalten Die Ser ver berwachung hat versucht die Server Jobvariable zu l schen Auftr ge f r diesen Rechner erhalten den Status ERROR I Ignore Der Server wird derzeit nicht berwacht Der Status muss manuell ge ndert werden Auftr ge f r diesen Rechner erhalten den Status HOSTWAIT Byte 3 frei 486 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs Byte 4 Diagnoseinformation des AVSSVDOG Eintrag der Socket Funktion die zu dem Zustand T gef hrt hat O connect 9 gethostbyaddr inetaddr recv send select read select write Byte frei oaz 2 o mJ 10 zugeh rige Fehlernummer Byte 11 frei Byte 12 19 Version des AVAS Servers AVSRECYV in der Form Vnn nann z B V7 0A00 Byte 20 frei Byte Byte 21 39 Startzeit des Servers Format yyyy mm dd hh mm ss Byte 40 frei Byte 41 59 Zeitpunkt an dem der Server erstmals nicht antwortet Format yyyy mm dd hh mm ss Hinweise e Der AVAS Agent AVSSINCM V7 0 ben tigt die Version des AVAS Servers Byte 12 19
294. ameter f r externes Programm programx waitx 1 CHAR Y N Y Job wartet auf die Beendigung des externen Programms Standard sonst Job wartet nicht hostx 32 CHAR Rechner auf dem das externe Programm programx ablaufen soll Standard mySAP com Rechner U21462 J Z125 7 499 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung Alle mit x Ziffer zwischen 1 und 9 endenden Parameter geh ren zum Job Step x Die ein zelnen Job Steps m ssen fortlaufend nummeriert sein beginnend bei 1 Die folgenden Parameter sind optional und gelten f r den gesamten Job Wenn sie nicht angegeben sind werden die im mySAP com Benutzerstammsatz angegebenen Werte ver wendet Print Parameter pridest 4 CHAR Ausgabeger t priimm 1 CHAR Y N Y Druck sofort ausgeben N nicht sofort ausgeben Standard pridel 1 CHAR Y N Y Spoolauftrag nach Ausgabe l schen N Spoolauftrag nach Ablauf der Spoolverweildauer l schen Standard pricopies 3 NUMC Anzahl der Ausdrucke 1 ist Standard priarch 1 CHAR Archivierungsmodus 1 Dokument nur drucken Standard 2 Dokument nur im optischen Archiv speichern 3 Dokument drucken und archivieren priber 12 CHAR Druckberechtigung Ab mySAP com 4 5 k nnen zus tzlich noch die folgenden Druckparameter verwendet wer den pribanner 1 CHAR mySAP com Deckblatt kein Deckblatt ausgeben Standard A Deckblatt ausgeben D Deckblattausgabe h ngt von d
295. amm AVAS SYS LOAD QUER aus SYSPRG AVAS 070 SYSTEM aufge rufen U21462 J Z125 7 2 1 4 Installation des AVAS Systems Installation und Generierung Folgende Voraussetzungen m ssen erf llt sein wenn das Programm gestartet wird e F r die Erstellung von SQL Statements INSERT FORMAT Das Programm ben tigt eine mit dem Linknamen AVSQUER zugeordnete Ausgabe datei SAM Datei eine bestehende Ausgabedatei wird berschrieben F r die Erstellung des LOAD Formats Das Programm ben tigt f r jede zu erstellende Tabelle eine zugeordnete Ausgabedatei SAM Datei eine bestehende Ausgabedatei wird berschrieben F r die Ausgabe dateien m ssen folgende Linknamen verwendet werden Tabelle Linkname caltab AVSCAL caldaysymtab AVSCDAY nettab AVSNET netdoktab AVSNETD netsymtab AVSNETS nettexttab AVSNETT ordertab AVSORD orderdoktab AVSORDD ordersymtab AVSORDS ordersturntab AVSORDT ordertexttab AVSORDX Eine SDF Syntaxdatei die die Anweisungen f r AVAS QUER enth lt muss aktiv sein Die ausgelieferte Systemsyntaxdatei SYSSDF AVAS 070 muss mit dem Dienstpro gramm SDF I in die aktuelle Systemsyntaxdatei eingemischt werden siehe dazu auch Handbuch SDF Verwaltung 14 In den System Parametern des verwendeten AVAS Systems muss dem Anwender die COPY ELEMENT Berechtigung f r jene Objekte auf die er zugreifen darf vergeben worden sein Die AVAS Zugriffsprozesse ZDD ZDL m ssen gestartet sein Die
296. amm Managers Geben Sie dazu in die Eingabefelder Folgendes ein Beschreibung Text unter der Ikone z B AVAS DOORS Befehlszeile Dateiname von FHS DOORS gefolgt vom Dateinamen der Para meterdatei f r FHS DOORS z B FHSD EXE AVASD DRS U21462 J Z125 7 AVAS DOORS 66 Installation und Generierung AVAS DOORS 2 3 4 Konfigurationen im BS2000 OSD Wenn nach dem Start von AVAS anstatt der Login Maske nur Fragezeichen angezeigt wer den ist die Datei MFHSROUT nicht auf dem neuesten Stand Der System Administrator muss dann die Datei MFHSROUT aktualisieren Wenn nach dem Start von AVAS DOORS keine grafische AVAS DOORS Maske sondern nur eine alphanumerische AVAS Maske angezeigt wird die Maske wird genauso ange zeigt als w re AVAS unter der verwendeten Emulation aufgerufen worden die Maske l sst sich aber nicht bedienen dann ist ein fehlerhafter Datenstationstyp in der PDN f r den PC deklariert Der System Administrator muss dann Folgendes eintragen DADM WDT vorrechner stationsname 13 4F U21462 J Z125 7 67 RZ Exits im AVAS System Installation und Generierung 2 4 RZ Exits im AVAS System ber die RZ Exits k nnen eigene in Assembler programmierte RZ Routinen in die Verar beitung des AVAS Systems eingebracht werden Dadurch ist es m glich die weitere Ver arbeitung zu beeinflussen RZ Exit AVEX0001und AVEX0002 Journalausgabe ber einzelne Anweisungen siehe Tabelle der Journals tze im Handb
297. angegeben wird wird ABLDUPZNO angenommen Hinweise e Wenn ABLDUP YES angegeben wird muss in den System Parametern eine Dateizu ordnung ber die Anweisung ABLDUP dateiname erfolgen e Beim Start der UPAM ZD wird gepr ft ob beide Dateien den gleichen Verarbeitungs stand haben Wenn nicht wird die UPAM ZD nicht gestartet das Duplikat muss mit dem BS2000 Kommando COPY FILE oder ber die Anweisung ABLCOPY YES erzeugt werden CENTRAL PASSWORD STD Bei der Anmeldung des CENTRAL Prozesses wird das intern fest gelegte Kennwort erwartet Korn j Der CENTRAL Prozess muss sich mit dem angegebenen Kennwort bei den Zugriffsprozessen anmelden Wenn CENTRAL PASSWORD nicht eingegeben wird wird STD angenommen Hinweise e Ein Kennwort ist mit der obligatorischen L nge von 4 Byte einzugeben e Die Anmeldungen sind nur dann erfolgreich wenn die bei den Ablaufsteuerungen und bei der Reorganisation definierten Kennw rter ZDD PASSWORD siehe Seite 114 und Seite 180 mit den hier eingegebenen bereinstimmen 108 U21462 J Z125 7 Administration von AVAS Starten und Beenden der AVAS Prozesse ENCRYPTION CODE Die Anweisung wird nur verarbeitet wenn ber die Generierungs Parameter PASSWORD ENCRYPTIONZYES eingestellt ist Wenn der Wert ge ndert wird k nnen die Netze im Produktions plan und in der Ablaufdatei nicht mehr verarbeitet werden c string Maximal 8 Zeichen lange Zeichenkette zur Verschl sselung der Kennw rter
298. ate des Schnittstellenaufrufs Der Bereich besteht aus einem Bereichskopf und einer Ergebnistabelle Die Gr e und die Struktur eines Tabelleneintrags wird von der Anweisung bestimmt Der Bereichskopf wird durch den Assembler Makro AVSASSBO bzw das Cobol COP Y Element AVSCOBBO beschrieben Er enth lt die Eintr ge Name einer SAM Datei in die die Ergebnisse satzweise abgelegt werden sollen Die neuen Daten werden dabei immer an das Ende der Datei ange h ngt Der bisherige Inhalt wird nicht berschrieben Zur sicheren Trennung der einzelnen Ergebnisse pro Anweisung wird dem Ergebnis ein Satz vorangestellt der ab Stelle 1 in der allgemeinen Lange f r Anweisungen den Anweisungsnamen enth lt und ab Stelle 33 das Datum der Anweisungsabgabe in der Form jjmmtthhmmss z B READ AVAS LIBRARY 010108112856 Anzahl der Elemente Netze oder Ereignisse f r deren Ergebnis Platz im Ausgabebereich vorhanden ist Wenn AVSONECT den Wert 0 enth lt wird das Ergebnis in die SAM Datei geschrieben Enth lt AVSONECT einen Wert ungleich 0 dann wird AVSOFILE ignoriert und die Ergebnisse der bearbeiteten Netze werden in die Ergebnistabelle eingetragen so weit der Platz daf r reicht Wenn zu we nig Platz reserviert wurde kann anhand der Felder AVSRNECT AVSRNEER und AVSRNEOK festgestellt werden ob alle Elemente fehler frei bearbeitet wurden oder nicht Es kann aber nicht immer festgestellt wer den welches Element zum Fehler gef hrt
299. atei ausgegeben Die auszugebende Menge kann ber die REPORT Anweisung THRESHOLD weiter einge schr nkt werden Die Anweisung wird nur beim OUT OF PLAN Report verarbeitet Die Anweisung muss nur bei FUNKTIONZPRINT angegeben werden SELECT STATUS liste status Liste von Status Werten der Netze deren S tze in die Reportdatei ausgegeben werden sollen Hier ist der globale Status anzugeben siehe GLOBAL STATE Seite 305 ERROR Netze im Status ERROR NO SUBMIT Netze die nicht zur Verarbeitung freigegeben wurden WAITING Netze die freigegeben aber noch nicht gestartet wurden STARTED Netze die gestartet und noch nicht beendet wurden Ausgenom men sind die Netze im Status ERROR die dort angezeigt werden ENDED Netze die sich normal beendet haben ABENDED Netze die sich abnormal beendet haben Wenn die Anweisung nicht angegeben wird werden keine Netze gem ihrem Status aus gew hlt In diesem Fall wird nur eine Auswertungsseite mit den Summen der Netze in den festgelegten GLOBAL STATE Werten ausgegeben Unter NET SUMMARY wird die Anzahl aller Netze aufgef hrt die gem dem Parameter der Anweisung NET NAME gefunden wurden Die Anzahl der Netze wird ber den Produktionsplan ermittelt U21462 J Z125 7 297 SORT FIELDS ORDER REPORT Anweisungen SORT FIELDS ORDER Festlegen der Reihenfolge der Sortierfelder Mit SORT FIELS ORDER wird die Reihenfolge der zugelassenen Sortierfelder ber den Feldnamen festgelegt
300. aten f r die Weiterverarbeitung in relationalen Datenbanken AVAS QUER schreibt die Daten wahlweise in eine Ausgabedatei die die Daten in SQL Form enth lt oder in Ausgabedateien die die Daten im LOAD bzw CSV Format ent halten Das LOAD Format ist ein spezielles INFORMIX Format Das CSV Format Comma Separated Value ist ein Format das von vielen Datenbank Systemen verarbeitet werden kann z B von Microsoft Access Die von AVAS QUER erstellte n Ausgabedatei en muss der Benutzer auf sein Zielsystem z B UNIX oder Windows System bertragen und zum Ablauf bringen bzw die Daten in das Datenbanksystem importieren Im Zielsystem kann der Benutzer durch geeignete Datenbankabfragen u a folgende abge leitete Informationen erhalten 1 In welchen Netzen wird ein bestimmter Job verwendet In welchen Netzen wird ein bestimmtes symbolisches Datum Symdat verwendet An welchen Tagen ist ein bestimmtes symbolisches Datum gesetzt ds I9 Abh ngigkeitsstrukturen in der Form Welches Netz h ngt von einem bestimmten anderen Netz ab Welches Netz hangt von dem Inhalt einer bestimmten Jobvariablen ab Welches Netz von einem Job eines anderen Netzes ab Welches Netz fragt eine bestimmte Ressource ab Welches Netz hangt von einem bestimmten Wert ab In welchen Objekten wird ein bestimmtes Dokument verwendet Welche Jobs laufen auf einem bestimmten PVS bzw welche Jobvariable enthalt das PVS 7 Von w
301. atieren 55 JRNDAT 55 Lesezugriff 6 Netze l schen 164 Reorganisation 165 Journalliste ausgeben 184 Journals tze Aufbau 187 der Anweisungen 191 in Druckdatei aufbereiten 184 Satzaufbau des festen Teils 197 Satzaufbau des variablen Teils 200 sichern 183 bersicht 191 Journalsatzkopf definieren 414 436 JRLDAT 26 55 532 JRNDAT 26 55 532 JVA LENGTH 532 JVA NAME 532 JVA PASSWORD 532 JVA POSITION 532 jvavak 35 552 Stichw rter N N 44 Name Benutzerkreis 29 Protokollelement 138 Systembenutzerkreis 27 NAME Parameter f r R 3 497 501 NET ACCOUNT 533 NET CAT 533 NETC Kontrollanweisung 35 NET CLASS 533 NET DELAY SOLUTION 533 NET DOC 534 NETLIB 54 534 NET LOG 534 NETMAP 54 534 NET NAME 534 NET NAME Reorganisationsanweisung 178 NETnnn 25 29 NET PARAMETER 534 NET STATUS 534 NETSYS 25 54 534 NET TEXT 534 NET TYPE 534 NET USER 534 Netz 534 Netzbearbeitung 534 Netzbeschreibung 2 535 Historie 69 Standardwerte definieren 38 Netzbibliothek NETLIB 54 NETSYS 54 Netzerstellung in externer Bibliothek 347 Netzsteuersatz 535 Netzstrukturdaten definieren 393 423 Netzverzeichnis Ablaufdatei definieren 421 Eintrag definieren 389 Netzverzeichnisbeschreibung definieren 435 Normal Benutzer 33 normale Beendigung der Zugriffsprozesse 112 553 LOG 533 Login Maske mit Fragezeichen 67 LOGSYS 25 54 163 533 l schen Netze aus Ablaufdatei 164 aus Journaldatei 164 l schen Standard Periode 331 M M Marki
302. ation 165 REPORT Generator 284 Ablaufdatei 527 ABLDAT 55 Dateiname 26 Duplikat 26 formatieren 55 Lesezugriff Programm Schnittstelle 376 U21462 J Z125 7 AVAS JV Schnittstelle 443 523 8 Ablaufkontrolle 443 Ablaufsteuerung 443 AVAS Konfigurationen 14 AVAS Konfigurationsdatei editieren 462 AVAS Konfigurationsdateien mySAP com 496 AVASNET RECORD A3 368 RECORD C3 366 RECORD D3 370 RECORD J1 359 RECORD J2 1 RECORD J3 364 RECORD M3 369 RECORD N1 350 RECORD N2 352 RECORD N3 354 RECORD N4 356 RECORD N5 358 RECORD W3 371 AVASNET Makro 347 AVAS Pool 136 AVAS Programmschnittstelle 373 AVAS Prozesse bedienen 127 beenden 104 starten 104 berwachen 127 AVAS QUER 16 1 Anweisung CREATE FORMAT 2 Anweisung SELECT OBJECT 243 Anweisung SIGNON 241 Anweisungen eingeben 8 Ausgabedatei 238 beenden 238 CSV Format 1 Daten in Datenbank einbringen 6 Datenbank erstellen 6 Datenbankabfragen 253 Datenbanktabellen 248 Fehlerbehandlung 6 INFORMIX Datenbank 231 installieren 6 Linknamen 3 U21462 J Z125 7 Stichw rter Arbeitsbereich Programmschnittstelle definieren 405 432 Meldungsausgabe unterdr cken 5 Aufbau Journals tze 7 Verst ndigungsbereiche 0 aufgel ste Abh ngigkeit 7 aufgel ste Startzeit 527 Auftrags Jobvariable 9 Aufbau 9 von Server Jobs aus modifizieren 492 Ausgabedatei weiterverarbeiten 276 ausgeben Diagnoseunterlagen 105 Journalliste 184 Auswahlkriterien OOP Report 282 automatische
303. ation Datenstrukturen Journalsicherung Not Journaldatei 53 07 Erf llung von FU C TYPE JVA 53 AVASJR 53 08 Fehler nach FU C TYPE JVA 53 AVASJR 54 7 DELAY SOLUTION IGNORE 54 AVASJR FU C J P S X 54 07 DELAY SOLUTION START FU C S54 AVASJR 54 8 DELAY SOLUTION CANCEL S54 AVASJR FU C J P S X 56 2 ENTER Parameter nach AVEX0401 S56 AVASJR oder wenn Korrektur durch Funktion CHANGE NET DESCRIPTION 51 07 Ende eines Netzes S51 AVASJR 51 08 Abbruch eines Netzes S51 AVASJR 09 00 Fehlermeldung MSG7 Text 08 01 Benutzerinformation aus AVA J M Text 08 02 Benutzerinformation aus AVA H Text Satzaufbau des festen Teils der Journals tze F3N AVASJRN N3 VERSION 070 um SATZBESCHREIBUNG JOURNALSICHERUNG UND NOTJOURNALDATET 3JRNS DS OF SATZBESCHR JOURNALSAETZE 3SNLN DS H SATZLAENGENFELD DS H RESERVIERT 3SYSID DS CL7 SYSTEM ID 3BKR DS CL5 BENUTZERK
304. ation sollte f r einen kleineren Zeitraum im Voraus erfolgen 2 14 Tage abh ngig vom Produktionsumfang und davon ob die Parameter bekannt sind Bei der Parametermodifikation ber CREATE PROD NET werden von allen Jobs die der Modifikation unterliegen Abbilder in der JMDLIB erzeugt e Die Produktionsfreigabe zum Ablauf SUBMIT NET sollte m glichst kurz vor dem Ver arbeitungstermin erfolgen 1 2 Arbeitstage Bei der Produktionsfreigabe entstehen vollst ndige Duplikate der Netze in der Ablaufdatei ABLDAT Zu fr h freigegebene Netze belasten unn tig die Inhaltsverzeichnisse der Ablaufdatei und die Suchvorg nge der Ablaufsteuerung U21462 J Z125 7 155 Administrationsaufgaben im Betrieb Administration von AVAS Um dem Benutzer die Beurteilung zu erleichtern werden nachfolgend diejenigen Anwei sungen aufgef hrt bei denen die gr ten Datenmengen bewegt werden m ssen und bei denen es gleichzeitig zu einer berschneidenden Benutzung von Dateien kommt Anweisungen Eingabe Ausgabe COLLECT NET PARAMS NPRLIB NPRLIB JRNDAT CREATE PROD NET NPRLIB NPRLIB JCLLIB JMDLIB JCLSYS JRNDAT SUBMIT NET NPRLIB NPRLIB JMDLIB ABLDAT JMDSYS JRNDAT Ablaufsteuerung ABLDAT ABLDAT JRNDAT JRNDAT Die kritischen Dateien sind wie folgt gekennzeichnet Anzahl der Zugriffe auf die Datei gro HH Anzahl der bewegten Datens tze gro Aus der Zusammenstellung ist ersichtlich
305. ationen muss eine g ltige Windows Anweisung entstehen die anschlie end anstelle des normalen Programmaufrufs ausgef hrt wird Beispiel REM AVAS CALL vbs wscript AVAS DATEINAME in prot hi puffer out F 002 484 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs 11 3 6 Ablaufsteuerung und kontrolle f r entfernte BS2000 Systeme Jobs auf entfernten BS2000 Systemen die nicht ber MSCF mit dem lokalen System ver bunden sind k nnen ebenfalls ber einen AVAS Server gestartet und berwacht werden 11 3 6 1 Starten des AVAS Servers unter BS2000 OSD Zum Starten des AVAS Servers wird die Prozedur AVS RECV aus der Bibliothek SYSPRC AVAS 070 aufgerufen Das Programm AVSRECV ben tigt ber SYSDTA folgen de Eingabeparameter CONTROL JV lt file name 1 54 gt Name der Jobvariablen mit der der AVAS Server gesteuert wird Standardm ig vorbelegt mit SYSJV AVAS RECV COMM PW lt name 1 8 gt Kommunikationskennwort mit dem sich Clients am AVAS Server anmelden m ssen PORT lt int 1025 65535 gt Portnummer unter der der AVAS Server erreichbar ist WORKDIR lt name 1 32 gt Suffix Name hinter dem der AVAS Server seine Work Dateien ablegt USERID lt name 1 8 gt Benutzerkennung unter der die AVAS Bibliotheken abgelegt sind Standardm ig vorbelegt mit AVAS Parameterangabe f r die Pro zedur 11 3 6 2 Beenden des AVAS Servers unter BS2000 0SD Die Operation
306. aufgaben im Betrieb 3 3 4 3 Bearbeiten der Protokolle Die Ablaufprotokolle von Jobs werden in einem AVAS Pool gespeichert Sie k nnen mit den folgenden Anweisungen hinzugef gt gel scht und angezeigt werden ADD JOB LOG Hinzuf gen von Protokolldaten DELETE JOB LOG L schen der Protokolle SHOW JOB LOG Anzeigen der Protokolle Die Protokolldaten werden ber EDT angezeigt Wenn in den Anweisungen der Parameter NET NAME angegeben wird entscheidet die angegebene Teilqualifizierung des Netznamens ob aus dem AVAS Pool entweder ein Netz oder ein Inhaltsverzeichnis aller Netze angezeigt wird Einzelne Netze k nnen mit der Markierung S oder Y zum Bearbeiten ausgew hlt werden Wenn im AVAS Pool keine Protokolle mehr vorhanden sind k nnen sie ber die AVAS Dialogfunktionen nicht bearbeitet werden Der Zugriff auf die Protokolle ist dann nur noch ber die Protokollsicherung m glich Voraussetzung ist dass die Protokolle bei der Reor ganisation gesichert werden siehe Reorganisations Parameter Die Anzeige der Netz bersicht in der Maske AVIO16 ist nach dem Parameter NET NAME sortiert Die Anzeige der Jobablaufe eines Netzes in der Maske AVIO17 ist nach den Parametern IND DATE TSN und JOB NAME sortiert Die Anzeige der Protokolle eines Jobs in der Maske AVIO18 erfolgt in der signalisierten Reihenfolge U21462 J Z125 7 153 Administrationsaufgaben im Betrieb Administration von AVAS 3 3 4 4 bersicht der Protokoll
307. b im Restart Fall Restart Anweisungen ausgef hrt werden sollen RUN CONTROL SYSTEM Name des Ablaufsteuerungssystems SELECT TURNUS Verarbeitungszyklus monatlich w chentlich t glich usw dem jeweils ein numerischer Wert zugeordnet wird Alle Strukturelemente deren SELECT TURNUS 0 oder gleich dem SELECT TURNUS des Netzsteuersatzes ist werden f r die Verarbeitung ber cksichtigt Ist auch Auswahlkriterium f r die Bildung von Netzablaufvarianten im Rahmen der Planung von Netzen 536 U21462 J Z125 7 Fachw rter SERVER NAME server name ist eine symbolische Bezeichnung daf r auf welchem Rechner host und unter welcher Benutzerkennung Userid ein Server Job ablaufen soll Startparameter Startparameter eines Netzes LATEST START DELAY SOLUTION LIFE TIME Startparameter eines Strukturelementes LATEST START DELAY SOLUTION statische Jobs Jobs in der JMDLIB die mehreren Netzen zugeordnet werden k nnen Strukturelement Einzelnes Element einer Netzstruktur zum Start eines Auftrags zur Bearbei tung eines Bedingungsauftrags oder zur Abfrage einer Bedingung Subnetz Ein Subnetz ist ein Netz das als Strukturelement eines Hypernetzes gestartet wird Subnetze k nnen keine weiteren Subnetze starten symbolische Starttermine Termine die bei der Erstellung und Bearbeitung der Standardnetze f r die Startzeit der Netze vergeben werden Die Vorgabe erfolgt im Netzparameter PLAN START Der AVAS Administrator tr gt die
308. bei der Ansto immer durch AVAS erfolgt Das Ereignis selbst muss der Benutzerjob im Server System setzen Wenn Ereignisse vom Server System an AVAS signalisiert werden sollen muss das Server System einen Job im BS2000 OSD starten der den Wert oder Status eines Be dingungseintrags ber die BATCH Anweisung MODIFY COND DESCR ndert oder den Inhalt einer Jobvariablen die ber COND TYPE JVA abgefragt wird U21462 J Z125 7 526 Fachworter Abh ngigkeit entsteht wenn ein Netz oder eine Indexstufe eines Netzes auf ein noch nicht eingetretenes Ereignis wartet bevor der Start erfolgen kann Ablaufdatei enth lt alle Informationen zur Steuerung der Abl ufe der angeschlossenen Ablaufsteuerungssysteme Im Arbeitsschritt Produktionsfreigabe werden die Strukturbeschreibung des geplanten Netzes und die entsprechende JCL in die Ablaufdatei bertragen Ablaufsteuerungssystem besteht aus einer AVAS Ablaufsteuerung und kontrolle mit dem bei der Gene rierung festgelegten Namen RUN CONTROL SYSTEM allen ber die Ablauf datei zugeordneten Netzen und den innerhalb der Netze zum Ablauf gebrach ten Jobs ABLDAT Linkname f r die Ablaufdatei ABLDUP Linkname f r die Kopie der Ablaufdatei aufgel ste Abh ngigkeit Das Ereignis von dem der Start eines Netzes oder einer Indexstufe abh ngt ist eingetreten Die Bedingung eines bereits wartenden Netzes ist erf llt aufgel ste Startzeit besteht immer aus Datum und Uhrzeit
309. belle der SERVER Bez glich der nderung einer Server Konfiguration siehe auch Abschnitt Prozess Server berwachung auf Seite 486 3 2 3 Serverumgebung im Prozess Server berwachung modifizieren F r die Administration des Prozesses Server berwachung wird als Benutzerschnittstelle eine kontrollierende Jobvariable zur Verf gung gestellt Der Name der Jobvariablen kann frei gew hlt werden und wird nicht in den Generierungs parametern gef hrt Er muss als Parameter beim Aufruf des Server Uberwachungspro gramms AVAS SYS LOAD SVDOG mitgegeben werden U21462 J Z125 7 131 Bedienen und berwachen der AVAS Prozesse Administration von AVAS Operation zur Aktualisierung der Serverumgebung Die kontrollierende Jobvariable kann ab der ersten Stelle ge ndert werden ber MODIFY JV JV IDENT JV NAME jvname VALUE C CONFIG Die Operation lautet CONFIG Die Konfigurationsdatei wurde in Bezug auf Servereintr ge ge ndert Die Server berwachung liest die Konfigurationsdatei und aktualisiert zu berwachende Serverumgebung Damit eine Synchronisierung mit anderen Prozessen m glich ist legt die Server berwa chung wie die anderen AVAS Prozesse Statusinformationen in der kontrollierenden Job variable ab Die kontrollierende Jobvariable kann folgende Werte enthalten analog zu den anderen AVAS Prozessen ab Spalte 2 in der L nge 10 STARTING1 Programmparameter werden bearbeitet die Konfigurationsdatei wird ge lese
310. ben werden APPLICATION ptnname proname jobvariable ptnname proname ptnname ist der Applikationsname des CENTRAL Prozesses proname ist der Prozessorname des CENTRAL Prozesses jobvariable Der Applikationsname des CENTRAL Prozesses steht ab Stelle 1 der Prozessorname ab Stelle 9 der angegebenen Jobvariablen Der Parameter APPLICATION muss angegeben werden FILE NAME ALL LAST dateiname ALL Alle durch das Programm SIGNAL signalisierten Protokolle sollen bertragen werden LAST Das letzte signalisierte Protokoll soll bertragen werden Hierbei wird stets das bis zu diesem Zeitpunkt noch nicht von TRANSFER behandelte Protokoll bertragen U21462 J Z125 7 148 Administration von AVAS Administrationsaufgaben im Betrieb dateiname Name einer bestimmten Protokolldatei Der Name des Protokolls muss dem CENTRAL Prozess signalisiert und dadurch bekannt sein Andernfalls wird die Angabe ohne Mel dung ignoriert Hinweis Der Standardwert des Parameters ist ALL Der Standardwert kann im CENTRAL Prozess in LAST ge ndert werden DELETE YES NO YES Die Datei soll nach fehlerfreier Speicherung gel scht werden NO Die Datei bleibt unter der erstellten Benutzerkennung erhalten Hinweis Wenn der Parameter DELETE nicht angegeben wird wird der Wert angenommen der beim Start von SIGNAL angegeben oder der ber CENTRAL gesetzt wurde Der DELETE Wert bei TRANSFER berlagert den bei SIGNAL gesetzten DELETE
311. bertragung mit DCAM von TRANSFER nach CENTRAL U21462 J Z125 7 151 Administrationsaufgaben im Betrieb Administration von AVAS Auswirkung von B Da CENTRAL die LOGSYS Bibliothek ber ILAM beschreiben kann PMOPEN OUT ent f llt die Ubertragung der Datei mit ITC zwischen CENTRAL und PLAM ZD bersicht SIGNAL DCAM CENTRAL IC ZDUPAM TRANSFER DCAM IIC ZDPLAM SAM ISAM ILAM y A B Protokoll LOGSYS dateien Bild 2 Ablauf der Protokollbehandlung Die Wege A bzw B werden gew hlt wenn die Protokolldatei bzw die LOGSYS Biblio thek von CENTRAL aus bearbeitet werden k nnen Der Weg A ist nur beim Betrieb auf einem Rechner m glich nicht im Mehrrechnerbetrieb Um die Protokolldateien zugreifbar zu machen muss z B Folgendes ber cksichtigt wer den Vor dem Aufruf des Programms TRANSFER muss CENTRAL die Zugriffsberechtigung auf alle Protokolldateien erhalten z B durch MODIFY FILE ATTRIBUTES FILENAME PARAMETERSCUSER ACCESS ALL USERS Um eine Zugriffsberechtigung nur f r AVAS zu definieren sei auf das Zugriffskontrollsystem SECOS verwiesen Vor Aufruf des Programms CENTRAL m ssen die Kennw rter f r die Protokolldateien aller Anwendungen angegeben sein ADD PASSWORD U21462 J Z125 7 152 Administration von AVAS Administrations
312. bis OLDRCS6 in der Ablaufdatei eingetragen sind und ob diese Ablaufsteuerungen normal beendet wurden Wenn eine Ablaufsteuerung gefunden wird die nicht normal beendet wurde wird der Auftragsschalter 11 gesetzt Es wird gepr ft ob mehr als 5 Ablaufsteuerungen in der Ablaufdatei eingetragen sind Wenn eine weitere Ablaufsteuerung gefunden wird wird der Auftragsschalter 11 gesetzt Wenn ON gesetzt ist wird der Auftragsschalter 11 abgefragt und der EDT beendet Die neuen Namen der Ablaufsteuerungen werden nicht mehr ermittelt Die vorgegebene neue System Parameterdatei SYSPAR wird mit EDT eingelesen Die Namen der neuen Ablaufsteuerungen NEWRCS 1 bis NEWRCS6 werden ermittelt und mit SET JV in eine Jobvariable mit dem Namen amp JVNAME NRCS bis NRCS6 ausgegeben 10 Die eingegebenen Werte und die ber die Ablaufdatei und die System Parameterdatei ermittelten Werte werden in die Datei ausgegeben die ber amp LISTE zugeordnet wurde Der EDT wird beendet 11 Die Datei amp LISTE wird mit SHOW FILE angezeigt 12 Es wird in der Prozedur der Auftragsschalter 11 abgefragt Ergebnis OFF Weiter in Prozedur ON Abbruch der Prozedur 13 Der Anwender wird gefragt ob die neuen Werte f r die AVAS SYSTEM ID und die Ablaufsteuerungen NRCS1 bis NRCS6 in die Ablaufdatei und die Journaldatei einge tragen werden sollen Antwort JA Weiter in Prozedur NEIN Abbruch der Prozedur 14 Die vorgegebenen neuen Werte werden mit DPAGE in di
313. bk netname CALENDAR NAME calendar RUN CONTROL SYSTEM STD avak OPERATION PRINT ALTERN NET NAMES bk_ netname Planung eines Netzes unabh ngig vom Kalender Bei der Planung unabh ngig vom Kalender muss der Netzname vollqualifiziert angegeben werden Parameter NET NAME Der Parameter SYMDAT NAME dient nur zur Auswahl der Strukturelemente im Netz Er entspricht dem Wert im Parameterfeld SYMDAT NAME der Maske AVP001 Wenn der Parameter EARLIEST START nicht angegeben wird wird die aktuelle Zeit als EARLIEST START angenommen Wenn ein Netz geplant werden soll das sich als fehlerhaft herausstellt sind im Protokoll der Verarbeitung Datum und Uhrzeit nicht versorgt Die Parameter PERIOD NAME und RUN CONTROL SYSTEM sind nicht zugelassen U21462 J Z125 7 325 CREATE PLAN NET BATCH Anweisungen CREATE PLAN NET NET NAME bk_ netname SYMDAT NAME symdat EARLIEST START tt mm jj hh mm ss OPERATION PRINT ALTERN NET NAME bk netname Protokoll der Verarbeitung F r jedes geplante Netz wird AVS8521 CREATE PLAN NET netname datum uhrzeit RESULT ergebnis ausgegeben oder eine Fehlermeldung Im Fehlerfall kann der Wert f r datum uhrzeit fehlen Protokoll der Verarbeitung wenn OPERATION PRINT angegeben wird Es wird die Liste AVLO14 Liste der f r die Planung ausgew hlten Netze ausgegeben Die Ausgabe erfolgt in die ber LINK AVASPRT zugeordnete Datei siehe Operation PRINT im Handbuch AVAS Anweisungen 1
314. blen Hinweis Der Wertebereich 000 bis 200 ist f r AVAS reserviert wert zugewiesener Wert der Systemvariable Beliebige Zeichenfolge aus 1 bis maximal 48 Zeichen einschlie lich Hochkommata Wenn wert in Hochkommata angegeben wird d rfen in der Zei chenfolge Leerzeichen enthalten sein F r ein Hochkomma inner halb von wert sind zwei Hochkommata anzugeben Hinweis Der Name einer Systemvariablen muss eindeutig sein S nnn Werte mit Syntaxfehlern werden mit einer Fehlermeldung abgewiesen Die Definitionen Name und Wert der Systemvariablen der Benutzer k nnen im laufenden AVAS Betrieb ge ndert werden Die Anzahl der vom Benutzer zu definierenden System variablen im Wertebereich 201 bis 999 ist auf 400 Variable begrenzt 34 U21462 J Z125 7 Installation und Generierung Generierung des AVAS Systems 2 2 2 4 Definieren der Ablaufsteuerung Die System Parameter der Ablaufsteuerung k nnen im laufenden AVAS Betrieb nicht ge ndert werden Mit AVAK wird die Ablaufsteuerung definiert Pr fintervall Routingcode Berechtigungs schl ssel und der JV Name werden festgelegt Eine Ablaufsteuerung muss mit dem Schl sselwort AVAK definiert werden Die Anzahl der Ablaufsteuerungen maximal 24 und deren unterschiedliche Eigenschaften m ssen in folgender Reihenfolge definiert werden AVAK avak control time routing code jvavak mscf control time avak Name der Ablaufsteuerung RUN CONTROL SYSTEM maximal 8 Zeichen c
315. bschnitt RZ Exit AVEX2001 auf Seite 90 und Handbuch AVAS Anweisungen 1 READ AVAS LIBRARY Condition RES anzeigen Der Ressourcenz hler und seine Belegung werden ausgegeben siehe Aufl sung des Makros AVSASSCD auf Seite 408 Netz und Jobstatus aktualisieren mit der ENTER Taste DUE Taste Zur Aktualisierung der Stati bei der Produktions berwachung mit NET CONTROL gen gt nun das Bet tigen der ENTER Taste Bisher waren das Kommando IGNORE und das Bet tigen der ENTER Taste n tig siehe Handbuch AVAS Anweisungen 1 U21462 J Z125 7 9 Hinweise zum Umstieg von AVAS V6 0A auf AVAS V7 0A Einleitung 1 7 Hinweise zum Umstieg von AVAS V6 0A auf AVAS V7 0A Generierungsparameter und Systemparameter Die Generierungsparameter und die Systemparameter k nnen unver ndert in die Ver sion 7 0A bernommen werden Die Systemparameter m ssen nicht neu generiert wer den Bibliotheken und Dateien Alle AVAS Dateien der Version 6 0A k nnen unver ndert in die Version 7 0A bernom men werden Auch mit AVAS V6 0A bereits geplante oder zur Verarbeitung freigegebe ne Netze k nnen mit AVAS V7 0A weiterverarbeitet werden Ein R ckumstieg von AVAS V7 0A auf AVAS V6 0A mit den AVAS Bibliotheken und Dateien ist jederzeit m glich solange keine neuen Funktionen verwendet werden RZ Exit Routinen RZ Exit Routinen der Version 6 0A k nnen nicht in allen F llen unver ndert in die Version 7 0A bernommen werden F r e
316. ch tzt kennwort Die ENTER Prozedur ist mit einem Kennwort gesch tzt Das Kenn wort ist in einer L nge von 4 Zeichen anzugeben alphanumerisch C oder sedezimal X 4 Der Parameter wird nur ausgewertet wenn der Parameter SERVER PROCEDURE NAME ungleich NONE ist CONFIG FILE NAME NONE Der Name f r eine Konfigurationsdatei muss in der Startprozedur f r AVSSINCM eingetragen sein Server Jobs k nnen nur gestartet werden wenn bei der Generie rung des Benutzerkreises als Server Partner STD angegeben wurde dateiname Name der Konfigurationsdatei Zu beachten ist dass diese Datei von allen Kennungen erreichbar sein muss auf denen durch die Ablaufsteuerung das Programm AVSSINCM gestartet wird CONFIG FILE PASSWORD NONE Die Konfigurationsdatei ist mit keinem Kennwort gesch tzt kennwort Die Konfigurationsdatei ist mit einem Kennwort gesch tzt Das Kennwort ist in einer L nge von 4 Zeichen anzugeben alpha numerisch C oder sedezimal X Beenden der Ablaufsteuerung Die Ablaufsteuerung wird durch die Operationen STOP und CANCEL beendet Diese Ope rationen k nnen sowohl ber das Kommando MODIFY JV als auch ber INFORM PROG siehe Handbuch AVAS Anweisungen 1 abgesetzt werden Die weiterhin zugelassene Operation SHUTDOWN ist nur ber das BS2000 Kommando MODIFY JV zugelassen Sie entspricht der Operation STOP LEVELZNET Hinweis Es wird empfohlen die Ablaufsteuerung nicht ber C
317. ches von 30 erh ht werden Wenn SECOND ALLOC 0 angegeben wird wird die Datei nicht erweitert Beispiel Vorgabe Formatierung keine SPACE 240 30 SPACE 0 0 SPACE 240 0 SPACE 3 3 SPACE 120 30 SPACE 120 0 SPACE 120 0 SPACE 3000 3 SPACE 3000 30 Wenn kein SECOND ALLOC angegeben wird wird eine Dateierweiterung ber die Angabe der Sekund rzuweisung in der Dateibeschreibung vorgenommen Die Formatierung erfolgt immer f r die Ablaufdatei und die Journaldatei Best nde in den Dateien gehen dabei ver loren e Ablaufdatei ABLDAT Die Ablaufdatei enth lt alle Informationen zur Steuerung der Ablaufe der angeschlos senen Ablaufsteuerungssysteme e Journaldatei JRNDAT In der Journaldatei werden die Aktionen der Benutzer am System und die Aktivit ten der Ablaufsteuerung protokolliert e Not Journaldatei JRLDAT Die Not Journaldatei des AVAS Systems legt AVAS im laufenden Betrieb an Die Jour nals tze die auf Grund eines Fehlers nicht in die Journaldatei ausgegeben werden k nnen werden in der Not Journaldatei abgelegt Um eine l ckenlose Liste der Jour nals tze zu erhalten m ssen vor dem Auflisten Journal und Not Journaldatei gemischt werden Hinweis Beim Hochfahren der ZDD werden alle Not Journaldateien in die Journaldatei ein gemischt U21462 J Z125 7 55 Generierung des AVAS Systems Installation und Generierung 2 2 5 2 AVAS Bibliotheken Jedem Benutzer von AVAS identifiziert durch Be
318. chr nkt die Auswahl auf Bedingungseintr ge ein die von einem bestimmten Netz erzeugt wurden Wenn bk_ weggelassen wird stellt die Funktion den eigenen Benutzerkreis dem Netznamen voran Wenn _date oder _time weggelassen werden liefert die Funktion Daten des zuletzt eingetragenen Bedingungssatzes Die Angabe ist nur f r die Bedingungstypen NET und JOB zul ssig CREATED BY INDEX index Schr nkt die Auswahl auf Eintr ge ein die auf einem bestimmten Jobindex erzeugt wurden Die Angabe ist nur f r den Bedingungstyp JOB zul ssig NET NAMES netname group Name des Netzes Wenn er vollqualifiziert angegeben wird liefert die Funktion Infor mationen zu einem Netz Strukturdaten oder Journale Wenn er teilqualifiziert angegeben wird liefert die Funktion ein Verzeichnis der Netze die der Teilqualifikation entsprechen NET STATUSSsstatus Schr nkt die Auswahl auf Netze ein die sich in dem angegebenen Status befinden Die m glichen Status finden Sie bei der Anwei sung SHOW NET STATUS im Handbuch AVAS Anweisungen 1 Die Angabe ist nur bei teilqualifizierten Netznamen m glich PERIOD NAMES period tt mm jj hh mm ss tt mm jj hh mm ss Angabe einer Periode Alle Netze deren Startzeit in diese Periode f llt sollen ausgew hlt werden Die Auswahl erfolgt bei der Ablaufdatei ABLDAT ber den Parame ter EARLIEST START und bei der Journaldatei JRNDAT ber den Parameter PLAN START aus den Netznamen da EARLIEST START
319. cht der Benut zer nicht in der AVAS Netzstruktur zu ber cksichtigen Wenn TRANSFER OPTION NO angegeben wird kann der Start eines Folgejobs zur Ubertragung von Protokollen unterbunden wer den unabh ngig davon ob im AVAS Job TRANSFER aufgerufen wurde oder nicht Wenn TRANSFER im AVAS Job aufgerufen wurde und bei der bertragung ein Fehler auftrat kann der Benutzer durch Auswerten des R ckkehrcodes im Job das normale oder abnormale Ende des Jobs bestimmen Die signalisierten Protokolle k nnen nachtr glich mit der Anweisung ADD JOB LOG gesammelt werden Wenn TRANSFER nicht im AVAS Job aufgerufen wurde und bei der bertragung eines Protokolls ein Fehler auftritt kann ber den Parameter TRANSFER OPTION gesteuert werden ob dieser Fehler auf den Jobstatus bertragen werden soll oder nicht 150 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb Wenn TRANSFER OPTION ENDED angegeben wird wird der Jobstatus von einem Fehler bei der Protokoll bertragung nicht ber hrt F r den Jobstatus ist ausschlie lich der beim Ende des AVAS Jobs gesetzte Job status ma gebend Wenn TRANSFER OPTION ERROR angegeben wird wird der Jobstatus ERROR gesetzt wenn bei der Protokoll bertragung ein Fehler auftritt Der Jobstatus ENDED wird nur dann erreicht wenn sich der AVAS Job nor mal beendet hat und die signalisierten Protokolle fehlerfrei bertragen wurden e DELETE YES NO bei den Programmen
320. d Kennwort der BS2000 Benutzerkennung des ENTER Aufrufs bergeben Diese Informa tionen k nnen durch die Ablaufsteuerung bereits korrigiert worden sein wenn dies durch die Anweisung CHANGE NET DESCRIPTION veranlasst wurde Wenn mindestens einer der Werte durch die RZ Routine ver ndert wird werden alle drei Werte als Parameter f r den ENTER Aufruf bernommen Die Anderung wird im Journal protokolliert Die Anweisung NETUSER siehe Abschnitt Starten und Beenden der Ablaufsteuerung auf Seite 113 wird vor Aufruf der RZ Routine berpr ft Folgendes ist zu beachten Wenn die Ablaufsteuerung mit NETUSER ERROR gestartet wird muss bei ENTER PARAMS NET im Netz oder im Job eine Benutzerkennung angegeben wer den auch wenn die endg ltige Benutzerkennung erst im RZ Exit gesetzt wird ggf kann eine Dummy Benutzerkennung angegeben werden z B EXIT Bei ENTER PARAMS LOGON muss eine Benutzerkennung in der LOGON Anweisung vorhanden sein Wenn die Benutzerkennung im RZ Exit gel scht wird kommt der Job unter der Benut zerkennung der Ablaufsteuerung zum Ablauf 85 U21462 J Z125 7 RZ Exits im AVAS System Installation und Generierung R ckgabe der RZ Routine an AVAS Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden pfixOK EQU X 00 Die Funktion soll durchgef hrt werden pfixNO EQU X 04 Die Funktion soll nicht durchgef hrt werden Di
321. d wie in der Readme Datei beschrieben beim Hochfahren des Rechners gelesen und beim automatischen Start des Windows Dienstes ausgewertet Die Bedeutung und der Wertebereich der einzelnen Parameter sind im Handbuch in der Freigabemitteilung und in der Readme Datei nachzulesen Mit dem Programm AVAS Konfiguration k nnen die Einstellungen in der Registrierdatenbank nachtr glich ge ndert werden Die ge nderten Einstellungen werden aber erst nach einem Neustart des Dienstes AvasService wirksam U21462 J Z125 7 11 1 2 448 AVAS SV Plattform bergreifende Jobsteuerung Installation von AVAS SV Wenn Sie diesen Dialog mit Weiter verlassen beginnt die eigentliche Installation Es werden alle Dateien der ausgew hlten Komponenten in den angegebenen Installationspfad auf Ihrem Rechner kopiert Die Registrierdatenbank wird aktualisiert und AVAS SV wird als Windows Dienst AvasService konfiguriert ber den Erfolg oder ber Fehler bei dieser bertragung werden Sie sofort am Bildschirm informiert Vor der bertragung und Konfiguration folgt der Schlussdialog mit einer kurzen Zusammen fassung der Installation Mit lt Beenden gt ist das Setup Programm beendet und die gew nschte Software betriebsbereit Im Men Start Einstellungen Systemsteuerung lt Dienste existiert ein Eintrag AVAS SV mit automatischer Startart und interaktiver Beziehung mit dem Desktop Unter Start gt Einstellungen gt Systemsteuerung gt Soft
322. d 1 Parameter Ein Server Job f r eine Windows Plattform hat z B folgendes Aussehen Kommandofolge 0 echo START AVAS Job 4 echo aus Netz 2 set filepath C AVAS TEMP Qif 6 EQU STD goto avas pl set filepath 6 avas pl echo Jobende Parameter Bereich 1 n S 011 Netzname j S 005 Jobname p Angabe des Pfades Den Parametern n und j wird der Wert ber die AVAS Systemvariablen zugewiesen dem Parameter p muss der Benutzer einen Wert z B ber die USER PAR FILE zuweisen USER PAR FILE p STD Bei CREATE PROD NET werden den Parametern die Werte zugewiesen Die Kommando folge und die Parameter mit den Wertzuweisungen werden in einem Element der JMDLIB abgespeichert 482 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs Bei SHOW PROD JOB erfolgt die Anzeige mit EDT wieder in den Arbeitsdateien 0 und 1 Arbeitsdatei 0 Arbeitsdatei 1 echo START AVAS Job 4 n netcheck echo aus Netz 2 j jobdel pedum p STD set filepath C AVAS TEMP if 6 EQU STD goto avas pl set filepath 6 avas pl echo Jobende Wenn die Server Jobs auf dem entsprechenden Rechner gestartet werden durch AVSSTRT sieht der Aufruf mitsamt der Parameter bergabe folgenderma en aus pfadname svjob n netcheck j jobdel p STD mit der Parameterzuordnung 960 pfadname svjob 1 n 2 gt netcheck 3 gt j 4 gt jobdel 5 g
323. da er ber eine eigene Schnittstelle XML mit diesem kommuniziert Die AVAS Server mit einer Version kleiner als V7 0 werden weiterhin mit der alten Schnitt stelle bedient e Das Eintragen der Versionsbezeichnung wird von der Server berwachung erledigt wenn diese erstmalig einen AVAS Server der V7 0 anspricht e AVAS Server der Version V4 1C10 liefern bereits ihre Version AVAS Server lt V4 1C10 k nnen auf die Anfrage nicht antworten und erhalten Unknown e Wennohne die AVAS Server berwachung gearbeitet wird so ist nach dem Installieren von AVAS SV V7 0 in dessen Server Jobvariablen der Wert V07 0A00 einzutragen e F rlaufende AVAS Server ist die entsprechende Version oder Unknown einzutragen Bei einem Eintrag Unknown wird ebenfalls weiter die bisherige Schnittstelle verwen det U21462 J Z125 7 487 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung Die Ablaufsteuerung setzt beim Starten von Server Jobs deren Status auch in Abh ngig keit der beiden ersten Stellen der SV JV RUNNING wenn der Wert in den beiden Stellen der SV JV gleich R ist HOSTWAIT solange der Wert in den beiden ersten Stellen der SV JV ungleich R ist ERROR wenn eine entsprechende SV JV nicht vorhanden ist In diesem Fall kann der Serverauftrag nicht zum Ablauf gebracht werden Funktionen des AVAS Prozesses Server berwachung Ermitteln der Server aus der Konfigurationsdatei Beim Starten der S
324. damit eine Verarbeitung durchgef hrt werden kann Der Parameter CREATED BY NET muss nur angegeben werden wenn die Bedingung ber die Parameter COND NAME und TYPE nicht eindeutig zu identifizieren ist Wenn er verwendet wird muss er vollqualifiziert angegeben werden Wenn kein Benutzerkreis angegeben ist stellt die Funktion den Benutzerkreis von COND NAME dem Netz namen voran e TYPE JOB MODIFY COND DESCRIPTION COND NAMES bk_ condname TYPE JOB COND VALUEstatus LIFE TIME tt mm jj hh mm ss CREATED BY NET bk netname date time CREATED BY INDEX index Mindestens einer der Parameter LIFE TIME oder COND VALUE muss angegeben wer den damit eine Verarbeitung durchgef hrt werden kann U21462 J Z125 7 335 MODIFY COND DESCRIPTION BATCH Anweisungen Der Parameter CREATED BY NET muss nur angegeben werden wenn die Bedingung ber die Parameter COND NAME und TYPE nicht eindeutig zu identifizieren ist Wenn er verwendet wird muss er vollqualifiziert angegeben werden Wenn kein Benutzerkreis angegeben ist stellt die Funktion den Benutzerkreis von COND NAME dem Netz namen voran Reicht der Parameter CREATED BY NET zur Identifizierung nicht aus muss zus tzlich der Parameter CREATED BY INDEX angegeben werden Der Parameter CREATED BY INDEX ist nur in Verbindung mit dem Parameter CREATED BY NET zugelassen e TYPE RES MODIFY COND DESCRIPTION COND NAMES bk_ condname TYPE RES COND VALUE status Der Parameter COND
325. dardwert f r den Steuerungs Parameter DELETE bei den Funktionen SIGNAL und TRANSFER ist NO Er kann hier auf YES ge ndert werden Die Bedeutung ist bei der Funktion beschrieben DEFAULT TRANSFER FILENAMES ALL LAST Der Standardwert f r den Steuerungs Parameter FILE NAME bei der Funktion TRANSFER ist ALL Er kann hier auf LAST ge ndert werden Die Bedeutung ist bei der Funktion beschrieben START PRIMARY SECONDARY PRIMARY Die Prim rtask von CENTRAL soll geladen werden SECONDARY Eine Sekund rtask von CENTRAL soll geladen werden Wenn START nicht angegeben wird wird SECONDARY angenom men ZDD PASSWORD STD kennwort STD Die Anmeldung bei der UPAM ZD erfolgt mit dem intern festgeleg ten Kennwort 142 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb kennwort Das Kennwort ist in einer L nge von 4 Zeichen anzugeben alphanumerisch CC oder sedezimal X Wenn ZDD PASSWORD nicht angegeben wird wird STD ange nommen Hinweis Die Anmeldung von CENTRAL an der UPAM ZD ist nur dann erfolg reich wenn das Kennwort mit dem bereinstimmt das beim Start der UPAM ZD mit CENTRAL PASSWORD definiert wurde ZDL PASSWORD STD kennwort STD Die Anmeldung bei der PLAM ZD erfolgt mit dem intern festgeleg ten Kennwort kennwort Das Kennwort ist in einer L nge von 4 Zeichen anzugeben alphanumerisch C oder sedezimal X Wenn ZDL PASSWORD nicht ange
326. den nur Listen der Netze mit dem angegebenen Na men erzeugt U21462 J Z125 7 Sichern der Journale und Protokolle 184 Sichern der Journale und Protokolle Sicherung und Reorganisation Beispiel BEGIN PROC LOGG CMD PAR YES PROC PAR amp SVFIL amp LIST amp HEAD amp FUNK ALL amp FORM LONG ESC CHAR C amp RE AR REMARK amp SVFIL JOURNALSICHERUNG REMARK amp LIST NAME DER AUSGABELISTE REMARK amp HEAD UEBERSCHRIFT DER JOURNAL LISTE REMARK amp FUNK FUNKTION ALL REMARK amp FORM FORMAT LONG RE AR SET FILE LINK LINK SYSLNK F NAME SYSLNK AVAS 070 ASSIGN SYSDTA SYSCMD START PROG FROM FILE PHASE LIB SYSPRG AVAS 070 SYSTEM ELEMENT AVAS SYS LOAD LIST JRNDAT INPUT amp SVFIL OUTPUT amp LIST HEAD amp HEAD FUNK amp FUNK FORM amp FORM END ASSIGN SYSDTA PRIMARY ENDE END PROC Die so erstellte LIST Datei kann mit folgendem Kommando ausgedruckt werden P
327. der Netzmaske pfixFMSG wird nicht verwendet pfixDFIX Ausgabe Parameter EQUATE f r L nge des Basisdatenteils U21462 J Z125 7 91 RZ Exits im AVAS System Installation und Generierung bergabe von AVAS an die RZ Routine und R ckgabe der RZ Routine an AVAS Anschlie end an den Basisdatenteil werden die Werte Daten der Maskenfelder in folgen der Form im Kommunikationsbereich bergeben maximale L nge 1930 Byte Satzl ngenfeld 2 Byte Reserve 2 Byte REM Param Name 8 Byte Feldl nge Maske 2 Byte maximale Lange 192 Byte Datenl nge 2 Byte Daten n Byte maximale Lange 192 Byte Das Ende der Daten wird durch den Wert Null X 0000 im Satzl ngenfeld erkannt Dies gilt auch f r die R ckgabe der Daten durch die RZ Routine Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden pfixOK EQU X 00 Die Felddaten werden bernommen und die Netzmaske wird ausgegeben pfixUPD EQUX O2 Die Felddaten werden bernommen aber die Netzmaske wird nicht mehr ausgegeben Modifikation erfolgt mit den bergebenen Daten pfixiGN EQUX 06 Abbruch der Modifikation f r diese Netzmaske Verhalten wie bei CMD IGNORE im Dialog pfixABE EQUX 08 Abbruch der Modifikation Verhalten wie bei CMD RETURN im Dialog Hinweise e Die RZ Routine bernimmt alle AVAS Variablen mit ihren Wertzuweisungen au er S nnn e Wenn die RZ Routine ander
328. der die systemweit f r alle Benutzer verf gbaren Jobs und JCL Bausteine gespeichert werden Dateiname der Benutzerbibliotheken in denen die Jobs und JCL Bausteine der Benutzer gespeichert werden Dateiname der Systembibliothek in der die systemweit f r alle Benutzer verf gbaren Dokumentationselemente gespeichert werden Dateiname der Benutzerbibliotheken in denen die Dokumenta tionselemente der Benutzer gespeichert werden Dateiname der Benutzerbibliotheken in denen die geplanten Netze der Benutzer gespeichert werden Dateiname der Systembibliothek in der die systemweit f r alle Benutzer verf gbaren ablauff higen Jobs gespeichert werden Dateiname der Benutzerbibliotheken in denen die ablauff higen Jobs der Benutzer gespeichert werden Dateiname der Systembibliothek in der alle Ablaufprotokolle von Jobs zentral gespeichert werden AVAS Pool Installation und Generierung NETSYS dateiname NETnnn dateiname JCLSYS dateiname JCLnnn dateiname DOCSYS dateiname DOCLIB dateiname NPRnnn dateiname JMDSYS dateiname JMDnnn dateiname LOGSYS dateiname Hinweise e Es m ssen mindestens eine JCLLIB und eine JMDLIB in den System Parametern vor gegeben werden auch wenn diese Dateien in der Anwendung nicht ben tigt werden Wenn die Dateien nicht angesprochen werden m ssen sie im System nicht vorhanden sein F r die JCLLIB und die JMDLIB gilt dies wenn nur mit JOB TYPE EXT gearbeitet wird e Di
329. der gleich gr er oder gleich und ungleich siehe Handbuch AVAS Anweisungen 1 Aufruf INFORM PROG an die Ablaufsteuerung die eigene MSCF Tabelle zu aktualisieren Die Tabelle der Ablaufsteuerung mit den Partner Systemen Hosts und die Tabelle mit den Servern k nnen im laufenden Betrieb mit folgenden INFORM PROG Aufrufen aktualisiert werden INFORM PROG MSG UHOST JOB ID lt tsn gt Anpassung der Host Tabelle INFORM PROG MSG USERVER JOB ID lt tsn gt Anpassung der Server Tabelle Siehe Handbuch AVAS Anweisungen 1 Keine Reorganisation wenn Protokolldateien im Status ASSIGNED Beendete Netze k nnen nur noch reorganisiert werden wenn auch die signalisierten Protokolldateien nach AVAS transferiert wurden siehe z B Abschnitt Verwalten der Ablaufprotokolle auf Seite 136 Reorganisation mit Periode Die Reorganisation kann mit Angabe einer Periode durchgef hrt werden siehe JOBLOG DELETE DATE auf Seite 176 Variable f r Parameter SERVER NAME und SERVER PASSWORD AVAS erlaubt nun auch die Modifikation von Variablen in der Netzbeschreibung Vari ablen f r SERVER NAME und SERVER PASSWORD k nnen beim Produzieren der geplanten Netze mit Werten versorgt werden Dies erm glicht ein flexibles Ansteuern der unterschiedlichen Server Bisher konnten nur die Variablen in den Jobs modifiziert werden siehe Handbuch AVAS Anweisungen 1 Auftragsbezogener Netzname
330. der kontrollierenden Jobvariablen Pflichtparameter lt integer 1 100 gt Zyklusdauer in Minuten f r das berpr fen der Verf gbar keit der Server Vorgabewert 5 Minuten lt integer 1 1440 gt Zyklusdauer in Minuten f r das berpr fen auf nderung der Konfigurationsdatei Vorgabewert 60 Minuten lt file name 1 54 gt Name der Konfigurationsdatei Pflichtparameter lt c string 1 4 gt lt x string 1 8 gt Kennwort f r Konfigurationsdatei Vorgabewert NONE list poss 16 lt name 1 8 gt Link Name im Namen der Server Jobvariablen in die von der Server berwachung der aktuelle Status des Servers eingetragen wird AVS SERVER STATE lt server jv link name gt lt servername gt Wenn die Ablaufsteuerung ohne den Startparameter SERVER JV LINK gestartet wird ist der Name der Ablauf steuerung anzugeben siehe auch Seite 119 Hinweis Die Ablaufsteuerung pr ft vor dem Starten eines Server jobs ber die Server Jobvariablen ob der Server aktiv ist Deshalb muss ihr der Link Name mitgeteilt werden Dies geschieht ber den Startparameter SERVER JV LINK der Ablaufsteuerung Die Namen m ssen bei Server berwa chung und Ablaufsteuerung identisch sein list poss 16 lt file name 1 54 gt NONE Namen der kontrollierenden Jobvariablen der Ablaufsteue rung Vorgabewert NONE 489 JVSVDOG SV CONTROL TIME CONFIG CONTROL TIME CONFIG FILE NAME CONFIG FILE PASSW SERVER JV LINK RCS JV
331. dies der zuletzt zugewiesene Wert LATEST START Der aktuelle Wert beim Netz f r LATEST START in der Form ttmmjj hh mm Wenn der Wert von LATEST START nach der Planung des Netzes ge ndert wurde ist dies der zuletzt zugewiesene Wert SYS ID Name des AVAS Systems in dem das Netz zur Verarbeitung geplant wurde USER Name des AVAS Benutzers der die nderung durchgef hrt hat Wenn der ma gebend ausgewertete Journalsatz von einer AVAS Ablauf steuerung ausgegeben wurde wird unter USER der Name des RUN CONTROL SYSTEM abgelegt Wenn sich innerhalb eines Netzes Jobs abnormal beendet haben JOB STATUS ERROR erreicht wird f r jeden Fehlerfall ein Protokollsatz beim Netz ausgegeben in der Form Jobname gem dem Eintrag in der Netzstruktur Inhalt der Auftrags Jobvariablen Inhalt der Fehlermeldung U21462 J Z125 7 ERROR JOB JV oder AVSnnnn 306 AVAS Reports OUT OF PLAN Report TSN TSN des Jobs wenn der ENTER Aufruf ausgef hrt werden konnte Folgende Listenausgaben k nnen ber den REPORT Generator mit FUNKTIONZPRINT erzeugt werden Liste L06001 OUT OF PLAN Report S Vnn yxmm L06001 REPORT Generator LIST OUT OF PLAN DATE ttmmjj TIME hh mm PAGE nnnn BAL STATE NAME STATE L E DELAY REAL START REAL END EARLIEST LATEST START SYS ID USER ERROR JOB JV TSN S Vnn yxmm L06001 REPORT Generator LIST OUT OF PLAN DATE ttmmjj TIME hh mm PAGE nnnn SUMMARY ERROR NO SUBMIT WAITING STARTED ENDED
332. dingung im Status NO OCCURE oder WAITING in den Status SKIPPED gesetzt werden muss U21462 J Z125 7 42 Installation und Generierung Generierung des AVAS Systems Die Werte RESTART WAIT ERROR und RESTART WAIT CONDITION beschreiben das Verhalten der Operation RESTART NET wenn durch die gew hlte Restart Variante ein Teil des Netzes erneut zum Ablauf kommen soll RESTART WAIT ERROR YES NO YES Strukturelemente im Status ERROR d rfen in den Status WAITING gesetzt werden NO Der Restart wird zur ckgewiesen wenn ein Strukturelement vom Status ERROR in den Status WAITING gesetzt werden muss Ausgenommen ist das Strukturelement im POINT OF ERROR RESTART WAIT CONDITION YES NO YES Bedingungen im Status OCCURRED sollen in den Status WAITING gesetzt werden Sie werden nach dem Restart erneut auf Erf llung berpr ft NO Bedingungen im Status OCCURRED werden beim Restart nicht bearbeitet Sie bleiben im Status OCCURRED und werden nach dem Restart nicht mehr berpr ft Bedingungen die durch die Operation RESTART NET vom Status NO OCCURE in den Status SKIPPED gesetzt wurden gelten als erf llt Sie werden von RESTART NET wie Bedingungen im Status OCCURRED behandelt Strukturelemente im Status EXECUTED FU A M D werden beim Restart nicht be arbeitet Sie bleiben im Status EXECUTED und werden nach dem Restart nicht mehr ausgef hrt Eine Ausnahme bildet das Strukturelement FU M mit TYPE RES Hier wird der Status EX
333. dung zum mySAP com System vor Ende des mySAP com Jobs verloren P Server Job wurde wegen Parameterfehler in der AVSSINCM Prozedur nicht gestartet C AVSSINCM konnte keine Verbindung zum AVAS Server aufnehmen 469 U21462 J Z125 7 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung Byte 185 A Zusatzstatus des Server Jobs E Keine Verbindung zum AVSSINCM beim Server Job oder keine Verbindung zum mySAP com System beim mySAP com Job Datei bertragung l uft Server Job ist startbereit Server Job bzw mySAP com Job angelaufen Server Job bzw mySAP com Job normal beendet Server Job bzw mySAP com Job abnormal beendet DE ipg Server Job wurde wegen Parameterfehler in der AVSSINCM Prozedur nicht gestartet oder mySAP com Job wurde wegen fehlerhafter Eingabe Parameter f r das Programm avasr3 nicht gestartet Byte 186 Prozess ID des AVSSTRT Eingetragen wird die Prozess ID von AVSSTRT der die JV Datei erstellt und den Server Job gestartet hat Byte 196 Jobtyp wenn Skript intern in AVAS verwaltet wird E wenn Skript extern im Server System existiert Byte 197 Exit Code des Server Jobs 4 Zeichen Byte 201 Fehlermeldungsnummer 4 Zeichen Meldungsnummer des Fehlers auf Grund dessen die Bearbeitung des Server Jobs abgebrochen wurde von AVSSTRT oder AVSSINCM Byte 205 reserviert f r Fehlerschl ssel 2 Zeichen Byte 207 Modus in dem AVSSINCM arbeitet 1 Zeichen S
334. dur aber die den jeweiligen Ziel rechnern zugeordneten Lagerorte einzusetzen sind muss MARENAV eine Zuordnungs tabelle zur Verf gung gestellt werden Diese Tabelle ist in einer SAM Datei zu hinterlegen wobei die einzelnen S tze dieser Datei folgendermaBen aufgebaut sein m ssen 4 Byte Katalogkennung des Zielrechners evtl rechtsseitig aufgef llt mit Leerzeichen 1 Byte Leerzeichen als Trennzeichen 8 Byte Dem Zielrechner zugeordneter Lagerort evtl rechtsseitig aufgef llt mit Leerzei chen Der Datentyp des Lagerortnamens muss alphanumerisch sein d h er darf nur Buchstaben Ziffern und die Sonderzeichen und enthalten F r jene F lle in denen eine CATID weder im Dateinamen angegeben noch von AVAS am RZ Exit bergeben wird ist ein Dateisatz mit einer aus vier Leerzeichen bestehenden Katalogkennung zu definieren Beispiel f r einzelne Dateis tze C3 CPU003 CI02 DA122ZE02 1 DVAOO1 2 DVA002 CENTRAL Die Lagerortdatei muss in der Prozedur SYSPRC AVAS 070 zugewiesen werden die der Benutzer zum Einleiten des AVAS Dialogs aufrufen muss Die Zuweisung muss mit dem Dateikettungsnamen MARENAVL erfolgen SET FILE LINK LINK NAME MARENAVL FILE NAME lagerortdatei MARENAV ermittelt beim RZ Exit ber RDTFT den Namen der Datei und holt sich daraus die notwendigen Informationen U21462 J Z125 7 267 Erstellen von Datentr gerlisten Kopplung AVAS mit MAREN Wenn keine Datei mit dem Dateikettungsnamen MARENAVL zugewi
335. e Wenn beim Schreiben in der Journaldatei ein DVS Fehler auftritt wird die Ausgabe von Journals tzen auf eine Not Journaldatei umgeleitet Ein Pr fix f r den Namen dieser Datei muss der AVAS Administrator in den System Parametern eintragen Der Name wird von AVAS um Datum und Uhrzeit erweitert Die Not Journaldatei wird nur eingerichtet wenn S tze ausgegeben werden m ssen Die Journals tze eines Netzes die in die Not Journal datei ausgegeben wurden k nnen im Dialog nicht angezeigt werden 3 1 4 Starten und Beenden der Ablaufsteuerung Die Katalog und die Benutzerkennung des BS2000 OSD unter der eine Ablaufsteuerung gestartet wird ist frei w hlbar ein Start unter der Benutzerkennung TSOS ist nicht erfor derlich Die Katalog und Benutzerkennung der Ablaufsteuerung ist wichtig f r den Ablauf von Hy pernetzen AVAS ben tigt bei den Subnetzen die Katalog und Benutzerkennung der Ab laufsteuerung des Hypernetzes um Informationen vom Subnetz an das Hypernetz zu ber geben Das bedeutet dass beim Einsatz von mehreren Ablaufsteuerungen innerhalb eines AVAS Systems eine Anderung der Katalog und Benutzerkennung einer Ablaufsteuerung nur vorgenommen werden darf wenn alle Ablaufsteuerungen neu geladen werden Die AVAS Systemkennung und der Name der Ablaufsteuerung m ssen in einem vorgela gerten Generierungslauf in einer AVAS System Parameterdatei hinterlegt werden siehe Abschnitt Definitionen f r die zentralen Zugriffsproze
336. e Abh ngigkeit von der Jobvariablen JVA1 SELECT bknet netname FROM ordertab WHERE Cordername JVA1 AND typ JVA AND function C n welchen Netzen besteht eine Abh ngigkeit vom Job 081 des Netzes QUER NET1 SELECT bknet netname FROM ordertab WHERE Cordername JOB1 AND typ JOB AND function C AND cond bknet QUER AND cond netname NETI n welchen Netzen besteht eine Abh ngigkeit von der Resource RES10 SELECT bknet netname FROM ordertab WHERE Cordername RES10 AND typ RES AND function C Welche Netze modifizieren den Eintrag f r die Resource RES1 SELECT bknet netname FROM ordertab WHERE Cordername RESI AND function M AND typ RES Welchen Netzbeschreibungen ist das Dokument QUER DOCUMENT 1 1 zuge ordnet SELECT bknet netname FROM netdoktab WHERE bkdok QUER AND dokname DOCUMENTI 5 In welchen Objekten wird ein bestimmtes Dokument verwendet Beispiele Welchen Netzen ist das Dokument QUER DOCUMENT 1 zugeordnet SELECT bknet netname FROM netdoktab WHERE bkdok QUER AND dokname DOCUMENT1 UNION SELECT bknet netname FROM orderdoktab WHERE bkdok QUER AND dokname DOCUMENTI 254 U21462 J Z125 7 Dienstprogramm AVAS QUER Datenhaltung f r AVAS QUER n welchen Netzen wird das Pubset ABCD verwendet SELECT bknet netname FROM nettab WHERE pvs ABCD UNION SELECT bknet netname FROM ordertab WHERE pvs ABCD
337. e Ablaufdatei die Anwei sung SUBMIT NET und die Ablaufsteuerung entlastet e Die Sammlung von Ablauf Parametern f r die Jobs eines Netzes in einer USER PARAM FILE oder ber COLLECT NET PARAMS ist der Modifikation von Jobs ber den Aufruf von Benutzermasken im Job bei CREATE PROD NET vorzuziehen e Im Netz ist bei allen aufgerufenen Jobs der Benutzerkreis bk oder bksys anzu geben Wenn der Benutzerkreis fehlt wird der Job zuerst in der JMDLIB des eigenen Benutzerkreises gesucht und falls er dort nicht gefunden wird in der Systembiblio thek JMDSYS e Die Produktionsfreigabe sollte erst 1 2 Arbeitstage vor dem Verarbeitungstermin durchgef hrt werden um die Ablaufdatei nicht berm ig anwachsen zu lassen Mit verschiedenen Taktzeiten siehe control time im Abschnitt Definieren der Ablauf steuerung auf Seite 35 kann das Durchsuchen der Ablaufdatei durch verschiedene Ablaufsteuerungssysteme optimiert werden e Wenn Protokolle eingesammelt werden sollen die Prozesse CENTRAL PRIMARY und SECONDARY unter der gleichen BS2000 Kennung wie die PLAM ZD laufen Wenn die Bibliothek LOGSYS kennwortgesch tzt ist muss das Kennwort mit ADD PASSWORD vor dem Programmstart im CENTRAL Sekund rprozess zugeordnet werden Das Eintragen der Protokolle in die LOGSYS Bibliothek wird dann durch den CENTRAL Prozess direkt vorgenommen und l uft nicht ber die PLAM ZD U21462 J Z125 7 157 Administrationsaufgaben im Betrieb Administ
338. e Ablaufdatei ABLDAT und die Journaldatei JRNDAT bernommen Die Steuerbl cke der ge nderten Ablaufdatei ABLDAT und der ge nderten Journaldatei JRNDAT werden mit MODE EXTENT in die ber amp LISTE zugeordnete Datei ausgegeben U21462 J Z125 7 61 Versionswechsel mit ABLDAT und JRNDAT Installation und Generierung 15 Die ber amp LISTE zugeordnete Datei wird mit EDT eingelesen Die neuen Werte f r die AVAS SYSTEM ID und die Ablaufsteuerungen NEWRCS1 bis NEWRCSS6 werden er mittelt Die Ausgabe von DPAGE wird gel scht und die neuen Werte in die Datei amp LISTE ausgegeben Die Datei amp LISTE wird mit SHOW FILE angezeigt 16 Die Jobvariablen amp JVNAME werden gel scht Hinweise e Der Abbruch der Verarbeitung wird ber die Auftragsschalter 10 und 11 gesteuert Der Auftragsschalter 10 wird gesetzt wenn der Benutzer den UPDATE nicht ausf hren will Der Auftragsschalter 11 wird gesetzt wenn bei der Pr fung der Eingaben oder der Daten in der System Parameterdatei in der Ablaufdatei und in der Journaldatei ein Fehler festgestellt wird e Esmuss der alte und der neue Name der ersten Ablaufsteuerung zur Kontrolle vorge geben werden e Ein Update von Dateien ABLDAT mit mehr als 5 Ablaufsteuerungen wird nicht durch gef hrt e Ein Update wird nicht durchgef hrt wenn die vorhandenen Ablaufsteuerungen nicht normal beendet wurden e Ein Update wird nicht durchgef hrt wenn in den neuen System Parametern mehr als 5 Ab
339. e Ausgabe von avasr3 besteht zum einen aus dem Programm Exit Code der R ckschl s se auf die Job Abarbeitung im mySAP com zul sst zum anderen aus einer LOG Datei die als UNIX bzw Windows Datei angelegt wird Der Programm Exit Code kann die Werte 0 bis 3 annehmen wobei die Werte folgende Bedeutung haben 0 Job ist ordnungsgem beendet 1 Job wurde abgebrochen 2 Fehler vor Start des mySAP com Jobs 3 Fehler nach Start des mySAP com Jobs Die LOG Datei wird unter dem Namen angelegt der in der Umgebungsvariablen AVASRSLOGFILE abgelegt ist Wenn diese Umgebungsvariable nicht gesetzt ist wird ein Name nach dem Muster ar3 datum zeit 1og generiert und die Datei im aktuellen Arbeitsverzeichnis erzeugt Die LOG Datei gibt in Zeile 1 die aktuelle Version von avasr3 aus Der weitere Inhalt der Da tei h ngt vom Ergebnis des avasr3 Laufes ab e f r Programm Exit Code gleich 0 oder 1 mySAP com Job Protokoll e f r Programm Exit Code gleich 2 oder 3 Fehlermeldung eines mySAP com Funktionsbausteins Name des mySAP com Funktionsbausteins der die Fehlermeldung ausl ste Eventuell weitere Informationen die die Fehlerursache kl ren helfen Bei der Fehlermeldung PROBLEM DETECTED wird der entsprechende Aus schnitt der mySAP com Systemlog Datei angef gt U21462 J Z125 7 11 5 5 2 502 AVAS SV Plattform bergreifende Jobsteuerung Steuerung von SAP R 3 Jobs mit AVAS 11 5 5 3 Umgebungsvariable Die
340. e Bibliotheken DOCLIB und DOCSYS m ssen zugewiesen werden auch wenn die zugeordneten Funktionen nicht genutzt werden e Bibliotheken die beim Hochfahren der PLAM ZD noch nicht bestehen werden einge 25 richtet U21462 J Z125 7 Generierung des AVAS Systems Installation und Generierung Dateinamen der Ablaufdatei der Journaldatei und der History Datei Die Namen dateiname der Ablaufdatei und der Journaldatei k nnen im laufenden AVAS Betrieb nicht ge ndert werden ABLDAT dateiname Dateiname der Ablaufdatei Diese PAM Datei muss mit der Prozedur AVS FORM Element in der Bibliothek SYSPRC AVAS 070 nach der Generierung f r den Betrieb formatiert werden Auf die Datei kann nur ber die Ablaufsteuerungen zugegriffen werden die zum Zeitpunkt der Generierung in der mit der Prozedur AVS GENSYSPAR Element in der Bibliothek SYSPRC AVAS 070 erzeugten System Parameterdatei vorhanden sind ABLDUP dateiname Dateiname f r das Duplikat der Ablaufdatei Diese Datei muss nur angegeben werden wenn der zentrale Zugriffsprozess mit der Anweisung ABLDUP YES gestartet wird Die Datei wird f r den Betrieb nicht formatiert Sie wird mit der Anweisung ABLCOPY YES beim Start des Zugriffsprozesses erzeugt JRNDAT dateiname Dateiname der Journaldatei Diese PAM Datei muss mit der Prozedur AVS FORM Element in der Bibliothek SYSPRC AVAS 070 nach der Generierung f r den Betrieb formatiert werden Auf die Datei kann nur ber die Benutzer
341. e L nge 192 Byte Satzl ngenfeld Reserve REM Param Name Feldl nge Maske Datenl nge Daten Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden Die Felddaten werden f r die Modifikation des Jobs bernom men Die Modifikation wird ausgef hrt Die Felddaten werden wegen eines Eingabefehlers nicht ber nommen Die Jobmaske wird mit bergebener Meldung erneut ausgegeben CMD CONTINUE wird gel scht Abbruch der Modifikation f r diese Jobmaske Verhalten wie bei CMD IGNORE im Dialog U21462 J Z125 7 pfixOK EQU Son pfixNO EQU 04 pfixiGN EQU X 06 96 Installation und Generierung RZ Exits im AVAS System pfixABE EQUX 08 Abbruch der Modifikation Verhalten wie bei CMD RETURN im Dialog Hinweise e Die RZ Routine bergibt alle AVAS Variablen mit ihren Wertzuweisungen au er S nnn e Bei pfixRSC X 04 sollte eine Meldung in Feld pfix FMSG bergeben werden e Wenn die RZ Routine andere Returncodes zur ckmeldet setzt AVAS im Feld MSG eine Meldung ab die Modifikation wird nicht durchgef hrt e Modifikationen durch die RZ Routine an den bergebenen Daten bernimmt AVAS nicht U21462 J Z125 7 97 RZ Exits im AVAS System Installation und Generierung 2 4 16 RZ Exit AVEX7101 Bevor die Netz und Strukturdaten in die Ablaufdatei eingetragen werden ruft AVAS die RZ Routine auf Die Felder des Kommuni
342. e Meldung AVS8509 wird in das Journal ausgegeben Wenn die RZ Routine andere Returncodes zur ckmeldet setzt AVAS eine Meldung ab die im Journal protokolliert wird Der Job wird nicht ber den ENTER Aufruf aufgerufen Die RZ Routine wird von AVAS ignoriert 86 U21462 J Z125 7 Installation und Generierung RZ Exits im AVAS System 2 4 9 RZ Exit AVEX0402 Wenn ein Netz mit dem Status RUNNING von der Ablaufsteuerung einen anderen Status erh lt und durch den automatischen Restart nicht erneut zum Ablauf kommt ruft AVAS diese RZ Routine auf Bei diesem einmaligen Aufruf werden folgende Informationen bergeben abweichend von den im Verst ndigungsbereich beschriebenen Feldern pfixUSR X 40 kein AVAS Benutzername pfixBKR X 40 kein AVAS Benutzerkreis pfixCAL X 40 kein Kalendername Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie folgt pfixNNAM Ausgabe Parameter Netzname pfixNSTA Ausgabe Parameter Netzstatus R ckgabe der RZ Routine an AVAS Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden pfixOK EQU X 00 Der Netzstatus wurde zur Kenntnis genommen Wenn die RZ Routine andere Returncodes zur ckmeldet setzt AVAS eine Meldung ab die RZ Routine wird ignoriert U21462 J Z125 7 87 RZ Exits im AVAS System Installation und Generierung 2 4 10 RZ Exit AVEX0403 Wenn ein BS2000 Job
343. e Returncodes zur ckmeldet setzt AVAS im Feld MSG eine Meldung ab die Speicherung wird nicht durchgef hrt e Nur Werte f r die Parameterfelder N nnn d rfen bergeben werden e Wenn eine Maske wegen des Returncodes X 02 nicht ausgegeben wird werden die von der RZ Routine bergebenen Parameter mit den auf der Maske definierten Feldern nicht abgeglichen Alle von der RZ Routine bergebenen Felder mit einem g ltigen Parameterschl ssel N nnn werden f r die Modifikation verwendet 92 U21462 J Z125 7 Installation und Generierung RZ Exits im AVAS System 2 4 13 RZ Exit AVEX6602 Bevor die Werte der Variablen N nnn gespeichert werden ruft AVAS die RZ Routine auf Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie folgt pfixNNAM Ausgabe Parameter Netzname pfixFNAM Ausgabe Parameter Name der Netzmaske pfixFMSG Eingabe Parameter Fehlermeldung nur bei RETURNCODE pfixNO pfixDFIX Ausgabe Parameter EQUATE f r L nge des Basisdatenteils bergabe von AVAS an die RZ Routine Anschlie end an den Basisdatenteil werden die Werte Daten der Maskenfelder in folgen der Form im Kommunikationsbereich bergeben Satzl ngenfeld 2 Byte Reserve 2 Byte REM Param Name 8 Byte Feldl nge Maske 2 Byte maximale Lange 192 Byte Datenl nge 2 Byte Daten n Byte maximale L nge 192 Byte Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeu
344. e Verarbeitung eines Server Jobs zu verhindern Das Server Script und die zugeordneten Parameter in der tempor ren Datei k nnen kontrolliert und ver ndert werden Die Information JOB START kann an andere Programmsysteme oder Arbeitsgebiete weitergegeben werden Der Ausgang AVEX0401 wird aktiviert wenn das Script eines Server Jobs von der Ablaufsteuerung aus der Ablaufdatei in die tempor re Datei vollst ndig und fehlerfrei ausgegeben wurde RZ Exit AVEX0402 Netz verl sst den Status RUNNING Ein Netzablauf mit dem Status RUNNING erh lt von der Ablaufsteuerung einen anderen Status z B ENDED ERROR Die RZ Routine erh lt an dieser Stelle die Steuerung Die Unterbrechung oder Beendigung des Netzablaufes durch die Ablaufsteuerung kann kontrolliert und protokolliert werden Die Information Netzname mit dem neuen Netzstatus kann an andere Programmsysteme oder Arbeitsgebiete weitergegeben werden Der Ausgang AVEX0402 wird aktiviert wenn ein Netz im Status RUNNING einen anderen Status erh lt und nicht durch den automatischen Restart erneut zum Ablauf kommt RZ Exit AVEX0403 Beendigung eines BS2000 Jobs einer S Prozedur oder eines Server Jobs erkannt Ein Auftrag erhielt den Status ENDED ABENDED oder ERROR Die RZ Routine erh lt an dieser Stelle die Steuerung und alle Informationen um die Position im Netz und die Ablauf bedingungen im System zu erkennen Der Inhalt der Auftrags Jobvariablen wird der RZ Routine zur Auswer
345. e vorhanden sind als angegeben Gel scht werden die Datens tze der Netze deren PLAN START am wei testen in der Vergangenheit liegt Wenn f r HISTORY KEEP RECORDS ein Wert kleiner als 64 angegeben wird werden auch die Eintr ge in den komprimierten S tzen gel scht Die Mittelwerte die Spannweite und die Standardabweichung werden auf Basis der angegebenen Anzahl neu berechnet Wenn die Parameter HISTORY DELETE DATE und HISTORY KEEP RECORDS angege ben werden werden zuerst die Datens tze gem HISTORY DELETE DATE gel scht und danach die Datens tze gem HISTORY KEEP RECORDS Die komprimierten S tze der Netze und der Auftr ge unterhalb der Netze werden gel scht wenn in den S tzen kein Ablauf mehr eingetragen ist Anzahl 0 Hinweise e Wenn unterschiedliche Mengen von Datens tzen JOB und NET gespeichert werden sollen sind folgende Parameter Kombinationen sinnvoll HISTORY SAVE OPTION STD mit HISTORY DELETE OPTION JOB und HISTORY DELETE DATE WOCHEV oder HISTORY KEEP RECORDS 64 und HISTORY DELETE OPTION STD und HISTORY DELETE DATE MONATV oder HISTORY KEEP RECORDS 200 Die symbolischen Perioden und Mengen sind nur beispielhaft e Wenn nur die Datens tze NET gespeichert werden sollen sind die Parameter HISTORY SAVE OPTION NET und HISTORY DELETE OPTION STD zu verwen den U21462 J Z125 7 175 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation HISTORY SAVE OPTION Die Reorganisationsanwei
346. earbeitet werden Dabei erfolgt die Anzeige mit EDT in den Arbeits dateien 0 Kommandofolge und 1 Parameter Ein Server Job f r eine UNIX Plattform hat z B folgendes Aussehen Kommandofolge 0 echo START AVAS Job 4 echo aus Netz 2 echo Jobende Parameter Bereich 1 n S 011 Netzname j S 005 Jobname t Angabe von Tagen Den Parametern n und j wird der Wert ber die AVAS Systemvariablen zugewiesen dem Parameter t muss der Benutzer einen Wert z B ber die USER PAR FILE zuweisen Die Systemvariable S 005 kann nur verwendet werden wenn der Jobname in der Struktur des Netzes ohne Benutzerkreis bk eingetragen wurde weil ein reserviertes Zeichen bei Parameterwerten ist USER PAR FILE t 14 Bei CREATE PROD NET werden den Parametern die Werte zugewiesen Die Kommando folge und die Parameter mit den Wertzuweisungen werden in einem Element der JMDLIB abgespeichert U21462 J Z125 7 475 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung 11 3 4 4 Starten von Programmen aus Server Jobs auf UNIX Systemen Beim Aufruf von Server Jobs k nnen auch andere Programme gestartet werden Hierzu bietet der AVAS Server folgende Schnittstelle an In der ersten Zeile eines Jobs muss folgende Zeile eingef gt werden AVAS CALL ext cmd AVAS DATEINAMEI param Dabei bedeuten Schnittstelle zum AVAS Server kein Kommentar AVAS CALL Aufruf der Schnittstelle Starten Prog
347. ehen oder Hinweis dass der Datentr ger nur im Restart Fall ben tigt wird U21462 J Z125 7 269 Erstellen von Datentr gerlisten Kopplung AVAS mit MAREN Die Transportliste wird sortiert nach 1 aktueller Lagerort 2 VSNs der Datentr ger Das AV Personal kann anhand dieser Liste die in einem Netz angesprochene Bandmenge zusammenstellen und ggf an die Anlage transportieren Beispiel f r den Aufbau einer Transportliste Ein Netz mit dem Namen BK01 GEH NET 001219 160500 besteht aus lediglich zwei Jobs Der erste Job mit dem Namen GEHALTO 1 verarbeitet Dateien des Pubset 0102 Der zweite Job mit dem Namen GEHALTO verarbeitet Dateien des Pubset C3 Insgesamt werden sieben Datentr ger ben tigt wobei das Band mit der VON Y1C002 in beiden Jobs verarbeitet wird und das Band mit der VSN Y1A003 zum Zeitpunkt der Produktionsfreigabe noch ausgeliehen ist Bei zwei der vom Job GEHALTO2 angefor derten Datentr ger handelt es sich um Privatb nder vom Typ T6250 Der Name des Verarbeitungssystems lautet RCS003 Beim RZ Exit wurde eine Lager ortdatei zugewiesen welche die in dem Beispiel auf Seite 267 aufgef hrten Dateis tze enth lt Die Transportliste hat den Dateinamen TRS AVAS RCS003 001218 113012 und wird unter der Kennung des Benutzers abgelegt der die Netze zur Produktion freigibt FILE TRS AVAS RCS003 021218 113012 AN PAGE 1 DATE TIME OF RELEASE 02 12 18 11 30 NET NAME BKO1 GEH NET 021219 160500 EARLIEST START
348. ehlers an die BATCH Anweisung zur ckgeliefert und als Pr fkennzeichen in der Netzbeschreibung NETLIB abgelegt F r jedes fehlerhafte Netz wird vor der Ausgabe der ersten Fehlermeldung ein Startsatz mit dem Netznamen ausgegeben Beim internen Aufruf von CHECK wird im Startsatz sowohl der Name der Bibliothek aus EXTERNAL FILE als auch der OUTPUT Netzname abgelegt AVS6050 START CHECK libname netzname Erfolgt die Pr fung vollst ndig Fehlerstufe 5 wird eine Ende Meldung ausgegeben AVS6051 END CHECK libname netzname Wenn die Pr fung abgebrochen wird Fehlerstufe 5 wird eine Fehlermeldung ausgege ben AVS6052 CANCEL CHECK libname netzname Wenn ein Fehler festgestellt wird der einer Strukturbeschreibung zugeordnet werden kann wird vor der Fehlermeldung ein Job Cond Identifikationssatz mit Index und Struktur Name ausgegeben AVS6040 IDENTIFICATION ind strukturname satzart F r jeden gefundenen Fehler wird mindestens ein Satz ausgegeben Der Benutzer kann das Protokoll ber EDT einsehen 318 U21462 J Z125 7 BATCH Anweisungen COPY ELEMENT COPY ELEMENT MODE LIBOUT LIBIN AVAS USER LIBRARY NETLIB JCLLIB DOCLIB CALLIB EXTERNAL FILE libname USER GROUP bk ELEMENT NAME element group OVERWRITE NO YES Der Parameter MODE ist nur mit einem der oben angegebenen Werte zugelassen Der Parameter USER GROUP ist nur in Verbindung mit MODE LIBIN zugelassen Die Parame
349. ehnung an die BS2000 DVS Bandverarbeitung erhalten die Datentr ger im Archiv eintrag das Attribut USER ACCESS FOREIGN READ ONLY d h auf diese B nder kann von anderen Kennungen aus nur lesend zugegriffen werden Diese Voreinstellungen k n nen bei Bedarf jederzeit ber einen MAREN RZ Exit ge ndert werden U21462 J Z125 7 265 Eintragen von VSNs in die JCL Kopplung AVAS mit MAREN 6 2 3 Behandlung von Fortsetzungszeilen Wenn bei Multivolume Dateien durch das Einf gen von VSNs die an MARENAV bergebe ne Kommandozeile zu lang wird wird das Kommando oder der Kommandoteil durch meh rere Kommandozeilen ersetzt ohne dass der Benutzer daf r irgendwelche besonderen Vorkehrungen treffen muss 266 U21462 J Z125 7 Kopplung AVAS mit MAREN Erstellen von Datentr gerlisten 6 3 Erstellen von Datentr gerlisten W hrend der Produktionsfreigabe erstellt MARENAV f r jedes Netz folgende 3 Dateien e Transportliste f r das AV Personal Dateiname beginnt mit TRS e Bandmontierliste f r den Operateur Dateiname beginnt mit OPR e Verlagerungsprozedur f r den Archivar Dateiname beginnt mit PRC Diese Dateien sind SAM Dateien wobei die beiden erstgenannten Dateien Drucksteuerzei chen enthalten Ausdruck mit PRINT FILE FILE NAME LAYOUT CONTROL PARAMETERS CONTROL CHARACTERS EBCDIC Da MARENAV beim SUBMIT von AVAS nur die CATIDs der Zielrechner erh lt in die Datentr gerlisten und speziell in die Verlagerungsproze
350. ehr gestartet KILL Der Prozess wird ohne R cksicht auf aktive Benutzer und auf in Bearbeitung befindliche Objekte Elemente beendet Neue Benutzer k nnen sich nicht mehr anmelden bzw k nnen die vom Prozess verwalteten Objekte nicht mehr bearbeiten MODIFY JV JV IDENTIFICATION JV NAME j vname VALUE C KILL Einmischen der Notjournale durch die UPAM ZD Wenn der Administrator die berwachende Jobvariable der UPAM ZD auf IN JRLDAT setzt werden die Notjournale sofort w hrend der laufenden AVAS Sitzung in die Journaldatei bertragen Eingabe MODIFY JV JV IDENTIFICATION JV NAME jvname VALUE C IN JRLDAT e Die bisherige Not Journaldatei wird geschlossen e Eine neue Not Journaldatei wird er ffnet e Die Eintr ge der alten Not Journaldatei werden in die Journaldatei bertragen Wenn es dabei zu Fehlern kommt werden die Eintr ge in die neue Not Journaldatei ber nommen Diese Funktion wird bei jedem Hochfahren der UPAM ZD automatisch durchgef hrt 128 U21462 J Z125 7 Administration von AVAS Bedienen und berwachen der AVAS Prozesse IN JRLDAT wird als Zustand in der berwachenden Jobvariablen angezeigt siehe auch Seite 133 Wenn Notjournals tze bernommen wurden wird ihre Anzahl von der UPAM ZD protokol liert 3 2 2 Bedienen der Ablaufsteuerung F r die Administration der Ablaufsteuerung werden zwei Benutzerschnittstellen zur Verf gung gestellt e Kommunikation mit dem Operator S
351. ei immer mit SPACE RELA PRIM ALLOC 30 SEC ALLOC 15 eingerichtet PERIOD NAME Die Reorganisationsanweisung bestimmt neben NET NAME die Netze die aus der Ablauf datei entfernt werden sollen PERIOD NAME f period tt mm jj tt mm jj tt mm jj period Symbolischer Name einer Periode Nur die Netze im Status ENDED oder ABENDED werden aus der Ablauf datei entfernt deren EARLIEST START innerhalb der Datumsgrenzen der Periode liegt Hmm Nur die Netze im Status ENDED oder ABENDED werden aus der Ablauf datei entfernt deren EARLIEST START mit dem angegebenen Datum ber einstimmt tt mm jj tt mm jj Nur die Netze im Status ENDED oder ABENDED werden aus der Ablauf datei entfernt deren EARLIEST START in den angegebenen Datums grenzen von datum bis datum liegt Dem ersten Datum wird die Uhrzeit 00 00 00 und dem zweiten Datum Uhrzeit 23 59 59 zugeordnet Hinweis Eine Uhrzeit kann nicht angegeben werden U21462 J Z125 7 179 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation START Die Reorganisationsanweisung START beendet die Eingabefolge von Anweisungen f r einen Reorganisationslauf Sie teilt dem Reorganisationsprogramm mit dass Anweisungen f r einen weiteren Reorganisationslauf folgen Wertzuweisungen aus dem vorausgegangenen Reorganisationslauf werden nicht ber nommen Alle f r einen weiteren Reorganisationslauf erforderlichen Anweisungen m ssen ange geben werden USER PASSWOR
352. eis des Netzes zu dem die Abh ngigkeit be steht f r typ JOB oder NET Wenn kein Benutzerkreis angegeben ist wird der des Netzes eingetragen Name des Netzes zu dem die Abh ngigkeit besteht Synchronisationsindex Restart Index aus Restartvariant 1 Restart Name aus Restartvariant 1 Restart Type aus Restartvariant 1 Restart Type aus Restartvariant 1 Restart Index aus Restartvariant 2 Restart Name aus Restartvariant 2 Restart Type aus Restartvariant 2 Restart Type aus Restartvariant 2 Restart Index aus Restartvariant 3 Restart Name aus Restartvariant 3 Restart Type aus Restartvariant 3 Restart Type aus Restartvariant 3 Name einer Kennung im BS2000 OSD Bei enter params NET und typ STD MOD EXT EXX aus der Netzbeschreibung Abrechnungsnummer im BS2000 OSD Bei enter params NET und typ STD MOD EXT EXX aus der Netzbeschreibung Typ von Value C Text eines COND VALUE O Text eines OCCURE VALUE Text eines ERROR VALUE U21462 J Z125 7 Datenhaltung f r AVAS QUER char 54 char 54 char 54 char 3 char 4 char 26 char 3 char 3 char 30 char 10 char 3 char 3 char 30 char 10 char 3 char 3 char 3 char 10 char 3 char 8 char 8 char 1 pvs jvname enterfile cond_index cond_bknet cond_netname sync_indexnr rest_indexnr1 rest name1 rest typ1 rest automatic1 rest indexnr2 rest name2 rest typ2 rest automatic2 rest indexnr3 rest name3 rest typ3 rest aut
353. ejenigen Satzschl ssel denen komplexe Daten zugeordnet sind gibt es Satz beschreibungen die ber den folgenden Makroaufruf aufgerufen werden k nnen Sssl AVASJRN amp pre ssl Satzschl ssel amp pre Pr fix Hinweis Im RZ Exit AVEX0001 werden die Journals tze weiterhin im Format von AVAS V2 0A und V3 0A Ausgabedatum ohne Jahrhundert bergeben Dabei muss der feste Teil mit VERSION 020 generiert werden Makroaufruf F3N AVASJRN amp PRE VERSION 020L EQU YES 188 U21462 J Z125 7 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Satzschl ssel Der Satzschl ssel bestimmt die im Datenbereich ausgegebenen Daten und legt ihre Struk tur und den Umfang fest 189 Makro Aufruf AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN JCLLIB JCLLIB AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN AVASJRN MSG7 Text S11 S12 S14 S15 S16 S21 Anweisung Anweisung Anweisung 531 532 S51 S52 S53 S54 S55 S56 S57 S58 S59 Anweisung SSL Ausgabe im Datenbereich keine Daten Benutzerinformation AVA MSG 7 Fehlermeldung Netzdaten CR PL NET Daten Strukturelement CR PL NET Netzdaten MOD PL NET Formatname Formattext Jobname Libname Daten USER PARAM FILE Systemvariablen zuordnen Maske Aufruf Baustein modifizieren Parameter Netzdaten SUBMIT NET Daten BS2000 Job S Prozedur Server Job Subnetz SUBMIT NET
354. elchem Benutzerkreis wird ein bestimmter Kalender verwendet In welchen Orders wird ein bestimmter SELECT TURNUS verwendet 9 Zu welchen Orders bzw Netzen gibt es ein Dokument in der DOCLIB U21462 J Z125 7 231 Dienstprogramm AVAS QUER Empfohlene Arbeitsweise Die nachfolgende Tabelle zeigt die erforderlichen Arbeitsschritte um die oben genannten Informationen zu erhalten N here Beschreibungen zu den Arbeitsschritten und Ergebnis sen finden Sie in den entsprechenden Kapiteln auf die in der Tabelle verwiesen wird Ergebnis AVAS QUER ist verf gbar AVAS Datenbestand wird gelesen Von AVAS QUER erstellte Ausga bedateien im SAM Format sind vorhanden Sie enthalten die se lektierten Daten die in eine relati onale Datenbank importiert wer den k nnen siehe Seite 238 Ausgabedateien sind im Zielsys tem verf gbar Datenbank und ihre Struktur Ta bellen wird erstellt Initialisierung siehe Seite 247 und Seite 248 Versorgen der Datenbank mit Werten Tabellen werden gef llt Informationen ber die Beziehun gen der AVAS Objekte in welchen Netzen wird ein be stimmterJob Symdat verwendet U21462 J Z125 7 Arbeitsschritt AVAS QUER installieren siehe Seite 257 Programm AVAS QUER aufrufen siehe Seite 234 an AVAS anmelden SIGNON Format bestimmen CREATE FORMAT Objekte ausw hlen SELECT OBJECT siehe Seite 238 und Seite 240 Programm AVAS QUER beenden siehe Seite 238 Die v
355. em Ablauf Windows steuerung Skript Datei ENTER PROC AVSSINCM Konfig Windows gt AVSRECV Skript Datei socket Verbindungsaufnahme _beginthread nach Auf tragseingang socket gt Thread er Thread AVSSTRT AVSSTRT SYSTEMC Windows Windows Job Job Bild 8 Kommunikation Ablaufsteuerung Windows Systeme Der allgemeine Verfahrensablauf ist auf Seite 454 beschrieben U21462 J Z125 7 477 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung Starten des Dienstes AvasService auf Windows Systemen Mit der Installation wird f r den Windows Dienst die Startart automatisch eingestellt An schlie end wird der Dienst automatisch gestartet Die Startparameter werden von der In stallation in der Registrierdatenbank bereitgestellt Der erfolgreiche Start wird ber den Status gestartet angezeigt In der Folge wird der Dienst bei jedem Start des Systems automatisch mit gestartet Erl uterungen zu Interaktive Beziehung mit dem Desktop Die Erlaubnis Interaktive Beziehung mit dem Desktop bzw Datenaustausch zwischen Dienst und Desktop zulassen ist notwendig um die ber den Dienst gestarteten Jobs interaktiv verfolgen und den automatisierten Ablauf gew hrleisten zu k nnen Wenn die ber den Dienst gestarteten Anwenderjobs
356. ement 432 AVSCOBCD COPY Element 433 AVSCOBCE COPY Element 434 AVSCOBJD COPY Element 435 AVSCOBUJN COPY Element 436 AVSCOBRT COPY Element 437 AVS CONF FILE 65 AVS CONF PASSW 465 AVSERLTC Schl ssel definieren 431 AVS JOB CLASS 466 AVS JOB ID 465 DEDE AVAS QUER Forts LOAD Format 231 Software Voraussetzungen 7 starten 234 Startprozedur 234 Struktur der Datenbank 7 Voraussetzung f r den Start 3 avasr3 494 installieren 6 AVAS R3JobControl 13 448 deinstallieren UNIX 450 installieren UNIX 445 installieren Windows 448 AVAS Report 281 528 AVAS Server AVSRECV 454 AvasService 448 beenden 478 starten 478 AvasService Windows Dienst 476 AVAS SV 439 deinstallieren BS2000 453 deinstallieren UNIX 450 deinstallieren Windows 452 installieren BS2000 449 installieren UNIX 445 installieren Windows 448 AVASSYS Dateikettungsname f r SYSPAR 107 AVAS System generieren 18 AVAS SYSTEM ID 22 Reorganisationsanweisung 170 AVAS SYSTEM LIBRARY 528 AVAS System Parameter 45 48 AVAS USER ID Reorganisationsanweisung 170 AVAS USER LIBRARY 528 AVAS Variablen symbolische Namen 44 AVAS Versionswechsel 58 AVEX0001 RZ Exit 68 81 AVEX0002 RZ Exit 68 81 AVEX0101 RZ Exit 82 AVEX0102 RZ Exit 69 83 AVEX0401 RZ Exit 69 4 AVEX0402 RZ Exit 70 87 U21462 J Z125 7 BATCH Prozess berwachen ber Jobvariable 133 Warteschlange 158 Bedingung 528 Bedingungseintrag 528 in
357. en FILE NAME STD SV dateiname STD Der Dateiname f r das SYSOUT Protokoll wird von SIGNAL ermit telt Wenn SYSOUT nicht auf eine Datei zugewiesen wurde wird das Programm SIGNAL mit Fehler beendet 144 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb Das Programm SIGNAL ist innerhalb eines Jobs unmittelbar nach einer SYSOUT Zuweisung aufzurufen Dabei ist zu beachten dass alle Informationen die vor der SYSOUT Zuweisung liegen nicht in die zugewiesene Datei flie en SV Die Dateinamen f r die Protokolldateien der Server Jobs die mit den Parametern stdout and stderr durch das Programm avslog sie he Abschnitt AVSLOG Zuordnung der Protokolldateinamen auf Seite 493 definiert wurden werden vom Programm SIGNAL ermit telt an CENTRAL signalisiert und in die LOGSYS eingetragen Der Aufruf von SIGNAL muss in der Startprozedur von AVSSINCM nach dem Start von AVSSINCM erfolgen SIGNAL pr ft bei FILE NAME SV ob Dateien mit dem Namen AVSSVLOG lt job id gt lt tsn gt vorhanden sind Die Log Dateien der Server Jobs werden vom AVAS Server nach Jobende dem Programm AVSSINCM bermittelt und von diesem unter den Namen AVSSVLOG lt job id gt lt tsn gt STDOUT bzw AVSSVLOG lt job id gt lt tsn gt STDERR im BS2000 OSD gespeichert Sind die gesuchten Dateinamen unter der Benutzerkennung vor handen werden die Namen in die Ablaufdatei eingetragen und die entsprechenden Dateie
358. en COPY ELEMENT Kopieren der Bibliothekselemente Mit COPY ELEMENT k nnen Elemente aus einer PLAM Bibliothek in eine AVAS Bibliothek kopiert werden oder aus einer AVAS Bibliothek in eine externe PLAM Bibliothek Die Ein Ausgabe von SAM Dateien wird nicht unterst tzt Die BATCH Funktion COPY ELEMENT pr ft bei MODE LIBIN und AVAS USER LIB NETLIB die Netze ber eine interne CHECK Funktion CHECK f hrt eine Strukturpr fung und eine Pr fung der Restart Varianten durch Zus tzlich werden auch die Parameter STR NET gepr ft und ob die Satzfolge den AVAS Konventionen entspricht Die Inhalte dieser Pr fung sind im Kapitel CHECK Funktion im Handbuch AVAS Anweisungen 1 beschrieben Bei ordnungsgem Ber Pr fung ohne fest gestelltem Fehler wird die Meldung AVS5810 ELEMENT SATISFIES AVAS CONVENTIONS aus gegeben Jeder festgestellte Fehler wird mit einer Meldung protokolliert Die Ausgabe der Meldungen erfolgt in eine PRINT Datei die ber das BS2000 Kommando SET FILE LINK LINK AVASPRT FILE NAME dateiname zugeordnet wird Dabei wird EXTEND YES gesetzt Ohne BS2000 Kommando werden die Meldungen in die Datei LST AVAS bk avuser jjmmtt hhmmss ausgegeben Stellt CHECK einen Fehler fest der weitere Pr fungen sinnlos macht Folgefehler wird die Pr fung abgebrochen CHECK arbeitet mit einer Gewichtung f r jeden bei den Pr fungen festgestellten Fehler Werden von CHECK Fehler gefunden wird als Return Code die Stufe des schwersten F
359. en Wenn die RZ Routine eine gr ere L nge bergibt wird die Bearbeitung mit einer Meldung im Journal abgebrochen e Im Journal wird zus tzlich zum Datensatz mit der JCL Anweisung auch das Resultat CHANGE NO CHANGE entsprechend dem Returncode abgelegt 102 U21462 J Z125 7 3 Administration von AVAS Der AVAS Administrator muss entsprechend den organisatorischen Gegebenheiten als ein AVAS Benutzer mit speziellen Berechtigungen in der Funktionstabelle definiert werden Die Aufgaben des AVAS Administrators umfassen folgende Bereiche e Starten und Beenden der Systemprozesse e Bedienen der Systemprozesse e Kontrollieren der Systemprozesse ber Jobvariable e Verwalten der Systembibliotheken e Sichern und Reorganisieren der AVAS Dateien e Administrieren der Benutzer e Optimieren des Systems Der AVAS Administrator sollte der einzige Benutzer sein der die folgenden Anweisungen geben darf e MODIFY SYSTEM PARAMS e SHOW SYSTEM PARAMS e SHOW USER e CANCEL USER und e SEND MESSAGE Wenn auch weitere AVAS Elemente zentral verwaltet werden sollen Kalender Perioden oder Ressourcen sind dem AVAS Administrator auch die zugeordneten Anweisungen vor behalten Die Anweisung START EXIT muss der AVAS Administrator f r sich und oder andere Benut zer zulassen wenn Benutzerfunktionen ber den RZ Exit AVEX2001 realisiert wurden U21462 J Z125 7 103 Starten und Beenden der AVAS Prozesse Administration von AVAS
360. en berschriften Satzschl ssel Benutzerkreis Netzname Plan Start Datum Plan Start Zeit Symbolischer Starttermin Index Jobname U21462 J Z125 7 Sicherung und Reorganisation U21462 J Z125 7 Inhalt Lange FU J P X 1 TYPEz STD MOD EXT 3 tt mm yyyy hh mm ss 19 hhh mm ss 9 tt mm yyyy hh mm ss 19 nnnnnn 6 H 2 01 2 System name 12 Vnn nAmmmm 10 host name 8 Vnn nAmmmm 10 nnn nnn nnn nnn 15 nnnnnn nnnn 11 nnnnnnnnnnnnnnnn 16 text 1 128 128 hhh mm ss 9 001 999 3 00 10 2 tt mm yyyy hh mm ss 19 hhh mm ss 9 tt mm yyyy hh mm ss 19 Text 129 256 128 Aufbau der History Datei Spalten berschriften Funktion Typ Startzeit Laufzeit Endezeit Anzahl Fehler Daten aus AVA HO1 Anweisung Anweisungsschl ssel Satznummer Betriebssystem Betriebssystem Version HOST BCA Name BS2000 Version IP Adresse CPU Verbrauch Anzahl UO User Information Wartezeit ERROR Anzahl ERROR Anzahl Zeiten ERROR Time 1 Wartezeit RESTART Time MONJV Inhalt bei ERROR ERROR Time 10 Sicherung und Reorganisation Aufbau der History Datei Eintragen und L schen von Ablaufen KEY 01 History Netz und KEY 02 History Job Neue Abl ufe werden bei der Reorganisation in die Summen S tze eingetragen SJOUR oder in d
361. en ob das Server System der AVAS Server AVSRECV oder AVSSTRT ausgefallen sind Demnach verh lt es sich wie bei Verbin dungsverlust CANCEL auf Server Job Dies erkennt AVSSTRT anhand des Returncodes seines system Aufrufs Es setzt den Status des Server Jobs auf A und meldet das Jobende U21462 J Z125 7 517 Einsatzvorbereitung AVAS SV Plattform bergreifende Jobsteuerung 11 7 Einsatzvorbereitung Bevor von AVAS aus Server Jobs gestartet und kontrolliert werden k nnen m ssen die in diesem Abschnitt beschriebenen Vorbereitungen getroffen werden Folgende AVAS Objekte sind entweder neu zu erstellen oder zu ndern e Netzbeschreibung e Generierungs Parameter e Konfigurationsdatei e Startprozedur f r AVAS Agent AVSSINCM e Startaufruf f r AVAS Server AVSRECV e Startprozedur f r AVAS Ablaufsteuerung e Startprozedur f r AVAS Server berwachung Das folgende Bild soll die Zusammenh nge der notwendigen Eintragungen verdeutlichen 518 U21462 J Z125 7 Einsatzvorbereitung Generierungsdatei Server name cos User dir path User dir path BK BK Startprozedur f r Server berwachung CONFIG FILE NAME SERVER JV LINK 519 comm pw Netzbeschreibung AVAS SV Plattform bergreifende Jobsteuerung Netz Parameter AVNOO1 NET USER NET PASSWORD NET CAT Job Parameter AVN009 002 hostname port nr comm pw hostna
362. en BS2000 System werden ber Strukturelemente mit FUNCTION J P gestartet wenn in der Netzbeschreibung f r die CATID des Netzes bzw Jobs ein Servername eingetragen ist Dabei k nnen die BS2000 Server Jobs wie gewohnt ber die AVAS Bibliotheken verwaltet bei TYPE STD oder MOD oder auf dem Server System bereitgestellt werden bei TYPE EXT Das Zielsystem wird ber die CATID angegeben Ansonsten werden die BS2000 Server Jobs beim Ablauf wie Server Jobs f r UNIX oder Windows Systeme behandelt Die Ablaufsteuerung startet einen AVAS Agenten AVSSINCM am lokalen AVAS Rechner unter BS2000 OSD der folgende Leistungen erbringt Herstellen der Verbindung zum AVAS Server auf dem entfernten BS2000 System ber die Sockets Schnittstelle bertragen des Skripts des Server Jobs TYPE STD oder MOD zum AVAS Server nitiieren des Starts des Jobs auf dem Server System ber den AVAS Server bernehmen des Ergebnisses des Job Ablaufs Status ENDED oder ERROR vom AVAS Server Hinweis LOG Dateien sind von AVSSINCM nicht zu bernehmen Die in den BS2000 Ser ver Jobs gestarteten Programme SIGNAL und TRANSFER kommunizieren direkt mit der DCAM Anwendung CENTRAL die die LOG Dateien vom BS2000 Server System bernimmt Ubergeben des Ergebnisses ber die kontrollierende Auftrags Jobvariable an die AVAS Ablaufsteuerung Die erforderlichen Komponenten f r den AVAS Server f r BS2000 OSD sind im Produkt AVAS SV BS2 enthalten
363. en Summen S tzen gel scht HISTORY Dabei sind folgende F lle zu unterschei den FunktionZSJOUR Anzahl kleiner als 64 PLAN START gr er als max alt Der Ablauf wird an die vorhandenen Daten angef gt FunktionZSJOUR Anzahl gleich 64 PLAN START gr er als max alt Der erste Eintrag wird gel scht Der Ablauf wird an die vorhandenen Daten angef gt FunktionZSJOUR Anzahl gleich 64 PLAN START gr er als min kleiner als max Der erste Eintrag wird gel scht Der Ablauf wird in die vorhandenen Daten gem PLAN START eingef gt Funktion SJOUR Anzahl kleiner als 64 PLAN START gr er als min kleiner als max Der Ablauf wird in die vorhandenen Daten gem PLAN START eingef gt Funktion SJOUR Anzahl gleich 64 PLAN START kleiner als min Der Ablauf wird nicht ber cksichtigt FunktionzHISTORY Anzahl gleich 64 PLAN START gr er gleich min kleiner gleich max bez glich HISTORY DELETE DATE Der Eintrag wird gel scht FunktionzHISTORY Anzahl kleiner als 64 PLAN START gr er gleich min kleiner gleich max bez glich HISTORY DELETE DATE Der Eintrag wird gel scht Funktion HISTORY Anzahl kleiner gleich 64 und HISTORY KEEP RECORDS kleiner als Anzahl Es wird jeweils der erste Eintrag gel scht bis Anzahl gleich HISTORY KEEP RECORDS FunktionzHISTORY Anzahl gleich 0 Der komprimirte Satz KEY 01 02 wird gel scht 221 1 U21462 J Z125 7 Sicherung und Reorganisation Hinweis
364. en alle Journalsicherungen eines Produktionszeitraums gemischt und sor tiert werden Beispiel Im folgenden Beispiel werden vier Journalsicherungen und eine Not Journaldatei sortiert BEGIN PROC LOGG CMD PAR YESCPROC PAR amp SORTO ESC CHAR C amp REMARK REMARK amp SORTO SORT AUSGABEDATEI REMARK REMARK JOURNALSICHERUNGE SET FELESEE LINK SORTINO1 F NAME AVAS USER SAVE JRNDAT 20050203 081807 ASET FILE LI LINK SORTINO2 F NAME AVAS USER SAVE JRNDAT 20050204 083906 SET FILE LI LINK SORTINO3 F NAME AVAS USER SAVE JRNDAT 20050205 081612 SEI FLLE SEI LINK SORTINO4 F NAME AVAS USER SAVE JRNDAT 20050205 082319 REMARK NOT JOURNALAUSGABEN CREATE FILE F NAME amp SORTO SUP PUB DISKCSPACE RELA PRIM ALLOC 120 SECO ALLOC 30 SET FILE LI LINK SORTOUT F NAME amp SORTO ASSIGN SYSDTA SYSCMD START PROG FROM FILE SORT SORT FIELDS 5 62 A CH END ASSIGN SYSDTA PRIMARY ENDE END PROG
365. en den Status HOSTWAIT D Deleted der Server wurde aus der Konfigurationsdatei entfernt Auftr ge f r diesen Rechner erhalten den Status ERROR I Ignore der Server ist derzeit nicht berwacht Der Status muss manuell ge ndert werden Auftr ge f r diesen Rechner erhalten den Status HOSTWAIT Starten der Server berwachung Mit dem Prozess Server berwachung wird das Programm AVAS SYS LOAD SVDOG gela den Dieses Programm f hrt die Server berwachung durch und ben tigt folgende Einga beparameter JVSVDOG file name 1 54 gt Name der kontrollierenden Jobvariablen Pflichtparameter Vorgabewert SYSJV AVAS SVDOG SV CONTROL TIME integer 1 100 gt Zykluszeit in Minuten f r das Uberpr fen der Verf gbarkeit der Server Vorgabewert 5 Minuten CONFIG CONTROL TIME integer 1 1440 gt 1 Zykluszeit f r das Uberpr fen auf Anderung der Konfigurationsda tei Vorgabewert 60 Minuten CONFIG FILE NAME file name 1 54 Name der Konfigurationsdatei Pflichtparameter CONFIG FILE PASSW c string 1 4 lt x string 1 8 gt Kennwort f r Konfigurationsdatei Vorgabewert NONE 124 U21462 J Z125 7 Starten und Beenden der AVAS Prozesse list poss 16 lt name 1 8 gt Link Name im Namen der Server Jobvariablen in die von der Ser ver berwachung der aktuelle Status des Servers eingetragen wird Name der Server Jobvariablen AVS SERVER STATE lt server jv link name gt lt servername gt Wenn die Ablaufsteue
366. enutzer Inhalt berblick ber die AVAS Funktionen Festlegung und Abwicklung der Produktion Kurzer Abriss ber die Administration Bestellnummer U5184 J Z125 10 U21462 J Z125 7 539 AVAS 7 08 BS2000 OSD AVAS Tabellenheft Zielgruppe AVAS Benutzer und AVAS Administratoren Inhalt Das Tabellenheft ist in einen Benutzer und Administratorteil gegliedert Es enth lt eine bersicht der Anweisungen und Parameter sowie eine grafische Darstellung der Masken folgen und Operationscodes Es gibt eine bersicht ber die Netzstatus die Status der Bedingungseintr ge sowie der Protokollstatus Au erdem sind alle Meldungen des AVAS Systems aufgef hrt Bestellnummer U5309 J Z125 10 ASSEMBH BS2000 Benutzerhandbuch Zielgruppe Assembler Anwender im BS2000 Inhalt Aufruf und Steuerung des ASSEMBH bersetzen Binden Laden und Starten Eingabequellen und Ausgaben des ASSEMBH Laufzeitsystem Listenausgabe der strukturierten Programmierung Sprachverkn pfungen Assembler Diagnoseprogramm ASSDIAG Dialogtesthilfe AID Meldungen des ASSEMBH Format der Assemblerbefehle Bestellnummer U5056 J Z125 3 BS2000 OSD BC V6 0 Dienstprogramme Benutzerhandbuch Zielgruppe Das Handbuch wendet sich an nichtprivilegierte Anwender und die Systembetreuung Inhalt Das Handbuch beschreibt die Dienstprogramme DPAGE V15 0A INIT V15 0A JMP V2 0A JMU V14 0A LMSCONV V3 3B P
367. eord nete Kennwort ber die REPORT Anweisung SYSTEM PASSWORD angegeben werden 7 1 4 Zuordnung der Arbeitsdatei f r den REPORT Generator Mit der REPORT Anweisung OUTPUT WORK FILE weist der Benutzer dem REPORT Generator eine Arbeitsdatei zu Diese Anweisung muss bei allen Werten von FUNKTION angegeben werden Wenn eine neue Arbeitsdatei angelegt werden soll muss eine u U vorhandene Arbeits datei vorher gel scht werden 286 U21462 J Z125 7 AVAS Reports REPORT Generator 7 1 5 Zuordnung der Reportdatei f r den REPORT Generator Mit der REPORT Anweisung OUTPUT REPORT FILE weist der Benutzer dem REPORT Generator eine Reportdatei zu Diese Anweisung muss nur bei FUNKTIONZPRINT ange geben werden Bei FUNKTION PRINT ist diese Datei die Ausgabedatei f r einen zu druckenden Report Wenn eine neue Reportdatei angelegt werden soll muss u U eine bereits vorhandene Datei vorher gel scht werden 7 1 6 Ausgaben des REPORT Generators in die Arbeitsdatei Mit den REPORT Anweisungen AVAS USER ID und NET NAME legt der Benutzer die Menge der in die Arbeitsdatei auszugebenden Netze fest Die Anweisungen m ssen nur bei FUNKTION CREATE angegeben werden 7 1 7 Ausgaben des REPORT Generators in die Reportdatei Mit den REPORT Anweisungen SELECT STATUS und THRESHOLD steuert der Benutzer beim OUT OF PLAN Report die Ausgaben des REPORT Generators in die Reportdatei Die Anweisungen m ssen nur bei FUNKTION PRINT angegeben werden
368. er RZ Exit aktiviert RZ Exit AVEX7102 JCL Modifikation bei Netzfreigabe e BS2000 Job S Prozedur In die BS2000 Jobs JCL Anweisungen k nnen Anweisungen oder Parameter einge f gt oder gel scht werden z B Kennw rter und DVS Anweisungen Die JCL des BS2000 Jobs kann kontrolliert protokolliert und ver ndert werden Die Information JOB FREIGABE kann an andere Programmsysteme oder Arbeitsgebiete weitergegeben werden z B Bandoperating mit Dateien Wenn JCL Informationen ber die AVAS spezifischen Modifikationsm glichkeiten nicht in den JCL Ablauf gebracht werden k nnen oder wenn der Benutzer programmtech nisch die JCL Anweisungen ndern oder erg nzen will kann er sich ber diesen RZ Exit jede JCL Anweisung zur Bearbeitung vorlegen lassen e Server Job In die Server Jobs Script Anweisungen k nnen Anweisungen oder Parameter einge f gt oder gel scht werden Das Script des Server Jobs kann kontrolliert protokolliert und ver ndert werden Die Information JOB FREIGABE kann an andere Programmsysteme oder Arbeitsgebiete weitergegeben werden Der Benutzer kann sich ber diesen RZ Exit jede Script Anweisung zur Bearbeitung vorlegen lassen U21462 J Z125 7 73 RZ Exits im AVAS System Installation und Generierung Der Ausgang AVEX7102 wird aktiviert wenn eine JCL Script Anweisung eines Jobs von der JMDLIB oder JMDSYS in die Ablaufdatei bertragen werden soll Die RZ Routine erh lt die JCL Script Anweisu
369. er AVAS SV Plattform bergreifende Jobsteuerung 11 2 Deinstallation von AVAS SV 11 2 1 Deinstallation auf UNIX Plattformen Analog zu install avs wird auf der MultiCD eine Deinstallationsprozedur uninstall avs ausgeliefert Um sie zu starten muss die CD erneut eingelegt und per Mount mit MountPunkt verbunden werden 11 2 1 1 Deinstallation von AVAS SV und von AVAS R3JobControl unter Solaris SPARC Die Software Deinstallation von AVAS SV auf dieser Plattform erfolgt ausschlief3lich durch uninstall avs Die Benutzerkennung unter der sh MountPunkt uninstall avs gestartet wird muss die der Installation sein Wenn diese die roor Kennung ist wird nach der Benutzerkennung der aktuellen AVAS Installation gefragt Es wird gepr ft ob AVAS SV unter dieser Kennung installiert ist Wenn AVAS SV vorhanden ist wird es f r die Deinstallation freigegeben Nachdem die Deinstallation best tigt wurde werden die entsprechenden Produktdateien und Verzeichnisse gel scht Anwender und Ablaufdaten werden aus dem Installationsverzeichnis gel scht Sie m ssen deshalb vorher gesichert werden Auch hier ist es sinnvoll diese erst gar nicht im Produkt installationspfad zu speichern Die Deinstallation von AVAS R3JobControl erfolgt analog zu der des AVAS Servers 450 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Deinstallation der AVAS Server 11 2 1 2 Deinstallation von AVAS SV unter IBM AIX HP UX UnixWare Tru64
370. er Einstellung des jeweiligen Ausgabeger ts Drucker ab pripage 1 CHAR Selektionsdeckblatt f r Report Listen kein Deckblatt ausgeben Standard A Deckblatt ausgeben 500 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Steuerung von SAP R 3 Jobs mit AVAS priexpir 1 NUMC Spool Verweildauer in Tagen bevor Auftrag gel scht wird prirecip 12 CHAR Empf nger des Spoolauftrages Standard mySAP com Benutzer F r prirecip muss der Inhalt des Parameters NAME aus der Datei sapuser ini eingetragen sein siehe Seite 497 prinum 10 INT Anzahl der Listzeilen pricol 10 INT Zeilenbreite der Liste Archivierungs Parameter arcobj 10 CHAR Objekttyp des mySAP com Objektes arcdoku 10 CHAR Dokumentart des Archivobjektes arcinfo 8 CHAR Informationsk rzel zum Archivierungsauftrag U21462 J Z125 7 501 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung Parameter zur Kennzeichnung eines Jobs zur Offline Sicherung offline 4 INT Maximale Laufzeit von avasr3 in Minuten Im folgenden Beispiel f r den Aufruf von avasr3 wird ein mySAP com Job der aus zwei ABAP 4 Programmen und einem externen Programm besteht angelegt und gestartet avasr3 destination G31HELIOS user AVASI job TESTJOB programl ZZTESTOO variantl MAX9999 program2 ZZTESTOI program3 home g3ladm prgl typ3 extern parameter3 parl par2 pridest HPME pricopies 3 Ausgabe Di
371. er Funktionen k nnen nicht unterdr ckt werden e Ein Verzicht auf die Ausgabe in das Journal kann unter Umst nden eine erhebliche Speicherersparnis bedeuten sowie eine Reduzierung des Bl tteraufwandes Satzarten sollten jedoch nur dann unterdr ckt werden wenn die Revisionssicherheit durch ande re Ma nahmen gew hrleistet ist und wenn nachgelagerte Verfahren nicht auf diesen Satzarten aufsetzen e F r die Analyse von Fehlern bei denen die Journals tze ben tigt werden muss ein Journal mit allen S tzen erzeugt werden Die Ausg nge AVEX0001 und AVEX0002 werden aktiviert bevor ein Journalsatz auf Grund einer AVAS Funktion in die Journaldatei ausgegeben wird RZ Exit AVEX0101 Sichern einer Netzbeschreibung Nachdem eine Netzbeschreibung in die NETLIB zur ck geschrieben wurde bergibt AVAS die Kontrolle an die RZ Routine Der Anwender kann eine Historie ber Entstehung und Ver nderungen der Netzbeschreibung erstellen RZ Exit AVEX0102 Sichern einer Jobbeschreibung Nachdem eine Jobbeschreibung in die JCLIB oder JMDLIB zur ck geschrieben wurde bergibt AVAS die Kontrolle an die RZ Routine Der Anwender kann eine Historie ber Ent stehung und Ver nderungen der Jobbeschreibung erstellen RZ Exit AVEX0401 Zugriff auf die JCL eines BS2000 Jobs einer S Prozedur oder auf ein Server Script in einer tempor ren Datei e BS2000 Job S Prozedur Nach der Ausgabe eines BS2000 Jobs in die tempor re ENTER Datei und bevor der ENT
372. er Protokolldateinamen i Steuerung von Jobs f r mySAP com mit AVAS Programm avas 3 Einbindung von avasr3 in die Jobsteuerung von mySAP com Einbindung von avasr3 in die AVAS Jobsteuerung installation und Konfiguration se xxx ka 40 ERA aaa a ak Melanie ehe Rn SOROR CR ah P IDE d Konfiguration f r den mySAP com Zugriff PRIOR AE V R Xue rk d Eingabe Paramete usa nah XS adus RR Qua ded dd ROW Umo Te E are LIII EFSER at ELE do acd EORR doa dod Ee ed TL 11 2 1 11 2 1 1 11 2 1 2 122 11 2 3 11 3 11 3 1 11 3 2 11 3 3 11 3 4 11 3 4 1 11 3 4 2 11 3 4 3 11 3 4 4 11 3 5 11 3 5 1 11 3 5 2 11 3 5 8 11 3 5 4 11 3 5 5 11 3 5 6 11 3 6 11 3 6 1 11 3 6 2 TLO 11 4 11 4 1 11 4 2 11 5 11 5 1 11 5 2 11 5 3 11 5 4 11 5 4 1 11 5 4 2 11 5 5 11 5 51 11 5 5 2 11 5 5 3 11 5 5 4 U21462 J Z125 7 U21462 J Z125 7 Beispigl JoDs rm Rn UNIX System Windows Plattformen Verhalten im Fehlerfall Einsatzvorbereitung AVAS Schnittstelle f r externe Server Fachw rter Lileraluf 224 22 res Stichw rter Inhalt 11 5 6 11 5 6 1 11 5 6 2 11 6 EL 11 8 AVAS 7 08 AVAS SV V7 0A AVAS SV BS2 V7 0 AVAS f r den Administrator Zielgruppe AVA
373. er SYMDAT NAME nicht zur Verf gung Deshalb wird bei diesen Netzen die Planung ohne symbolischen Starttermin angenommen In den S tzen mit KEY 02 und 04 FUzJ P X TYP SUM JOB wird der symbolische Starttermin abgelegt mit dem das Netz geplant wurde Die Werte die der Anwender ber die AVAS Anweisung AVA H01 an AVAS ber geben hat pr ft AVAS nicht Die Werte werden ungepr ft in den HISTORY Satz mit KEY 04 bernommen Feld HO4AUINF INFO aus AVA H Anweisung Alle Zeiten Laufzeiten Wartezeiten etc werden aus den Zeitstempeln der Journal s tze berechnet Diese Zeitstempel gibt die AVAS Ablaufsteuerung aus f r den Start und das Ende von Netzen und Jobs das Warten auf die Erf llung einer Bedingung und die Erf llung einer Bedingung Bei Server Jobs FU X entspricht die Joblaufzeit der Verweildauer der Prozedur zum Starten des Agenten AVSSINCM im BS2000 OSD Wenn die Ablaufsteuerung w hrend des Ablaufs eines Jobs abnormal beendet wird wird dadurch die Laufzeit verf lscht Der Journalsatz mit der Jobendezeit wird n mlich erst beim Wiederanlauf der Ablaufsteuerung ausgegeben w hrend der Job aber schon vorher den BS2000 Status T oder A erreicht hat 229 U21462 J Z125 7 Aufbau der History Datei Sicherung und Reorganisation 230 U21462 J Z125 7 5 Dienstprogramm AVAS QUER Das Programm AVAS QUER liest im BS2000 OSD den AVAS Grunddatenbestand und selektiert daraus D
374. er absolute Pfadname vollst ndig in der Netzbeschreibung Maske AVN009 angegeben werden z B f r UNIX Systeme home user1 buchhaltung jobnamel f r Windows Systeme D buchhaltung jobnamel Vorteil ist dass der Pfadname vom Eintrag in der Konfigurations datei entkoppelt ist und in voller L nge in der Netzbeschreibung sichtbar ist Bei Angabe eines absoluten Pfadnamens in der Netzbeschreibung wird die Angabe dir ignoriert Die bisherige Funktion f r die Angabe des Pfadnamens ber die Konfigurationsdatei wird auch weiterhin unterst tzt z B f r bei UNIX Systemen home directory dir aus Konfigurationsdatei jobname dir ist ein wahlfreier Eintrag Wenn er fehlt oder als Leerstring angegeben ist werden die entsprechenden Dateien im Home Directory der lt userid gt UNIX System oder im SystemRoot Ver zeichnis Windows System gesucht In der Konfigurationsdatei k nnen auch absolute Pfadnamen ange geben werden F r einen BS2000 Server ist STD einzutragen Externe Jobs sind unter der Benutzerkennung hinterlegt 460 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs pfad Work Verzeichnis F r einen BS2000 Server ist STD einzutragen Das Work Ver zeichnis wird vom AVAS Server festgelegt Das Work Verzeichnis zur Ablage der tempor ren Server Dateien wird bei UNIX und Windows Systemen bei der Installation erfragt und in der Umgebungsvariable
375. er aus der Netzbeschreibung sonst NONE AVS USER ACCOUNT Bei einem BS2000 Server Job Wert f r Account aus der Netzbeschreibung sonst NONE AVS USER ID Bei einem BS2000 Server Job Wert f r Benutzerkennung aus der Netzbeschreibung sonst NONE AVS USER PASSW Bei einem BS2000 Server Job Wert f r Kennwort der Benutzerkennung aus der Netzbeschreibung sonst NONE 466 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs AVS DEF COMM PASSW INIT NONE Standard Kommunikationskennwort ber dieses Kennwort erkennt AVSRECV dass die Nachricht von einem berechtigten Sender stammt Es muss mit dem Kennwort bereinstimmen das AVSRECV beim Hochfahren genannt wird AVS DEF DIRECTORY INIT NONE Directory in dem AVSRECV auf dem Server Rechner Shell Skripte suchen soll kann durch Angaben im Dateinamen verl ngert wer den AVS DEF HOST NAME INIT2 NONE Wenn SERVER NAME STD Host Name oder Internetadresse des Server Rechners auf dem Jobs ablaufen sollen AVS DEF SERVER PASSW INIT2 NONE Wenn SERVER NAME STD Kennwort das der Benutzer in der Maske AVNOO9 angeben muss um Server Jobs starten zu k nnen AVS DEF SERVER VERS INIT2 NONE Wenn SERVER NAME STD Version Vnn nann des AVAS Servers AVS DEF PORT NUMBER INIT NONE Wenn SERVER NAME STD Standard Portnummer unter der der AVSREOV erreichbar ist AVS DEF USER ID INIT2 NONE
376. er grafischen Masken verwendet werden und die eigentliche AVAS Sitzung unter FHS DOORS ablauft muss FHS DOORS installiert und ohne Probleme ablauff hig sein Dies gilt auch f r die von FHS DOORS verwendete Terminal Emulation Wenn Sie z B die DOORS Mini Emulation oder MT9750 f r die Verbindung zum BS2000 Host verwenden m ssen Sie eventuell erst einen Verbindungsnamen einrichten Die Beschreibung von FHS DOORS z B zu Installa tion und Konfiguration Sitzungen Konfigurationen im BS2000 OSD und der DOORS Mini Emulation z B zu Verbindungen und Verbindungsnamen finden Sie im Handbuch FHS DOORS Grafische Oberfl che f r BS2000 Anwendungen 8 Weitere Installations und Konfigurationshinweise entnehmen Sie bitte der Freigabemittei lung zu AVAS U21462 J Z125 7 2 3 2 64 Installation und Generierung AVAS DOORS 2 3 3 Konfiguration von AVAS DOORS Um mit den AVAS DOORS Masken unter FHS DOORS arbeiten zu k nnen m ssen Sie FHS DOORS nur bekannt machen in welchem Verzeichnis die AVAS DOORS Masken abgelegt sind Dazu w hlen Sie beim Erzeugen einer neuen Sitzung mit FHS DOORS in der Dialogbox Neue Sitzung das entsprechende Verzeichnis in der Liste Ressourcenpfad aus Alle weiteren Konfigurationen wie z B Schriftart Darstellungsattribute oder 3D Effekt w hlen Sie direkt ber das Men Konfiguration von FHS DOORS aus Wichtig ist die Aus wahl einer geeigneten Schriftart Wenn eine zu gro e Schriftart ausgew
377. erer Netze gleichen Namens bis auf die Startzeit NET USER Standardwert f r USER Netz Sammlung von zusammenh ngenden Jobs deren Ablauf unter Ber cksichti gung der logischen und zeitlichen Abh ngigkeiten zueinander strukturiert und festgelegt wird Netzbearbeitung Bearbeitung der Netzbeschreibung neu anlegen ndern kopieren l schen anzeigen U21462 J Z125 7 Fachworter 534 Fachw rter Netzbeschreibung Strukturbeschreibung des Netzes und Angabe ber Inhalt und Reihenfolge der Verarbeitungsschritte innerhalb eines Netzes wird von der Produktionsplanung erstellt Netzsteuersatz Bestandteil der Netzbeschreibung enth lt netzglobale Parameter NPRLIB Linkname f r die Bibliothek der geplanten Netze Operation Kurze Zeichenfolge zur Steuerung des Dialogs in Masken Eine Operation wird im Feld CMD eingegeben OUT OF PLAN Report In diesem Report werden Netze ausgewiesen die eine definierte Versp tung berschritten haben und oder die sich in einem ausgew hlten Status befinden PERDAT Linkname f r die Periodendatei Periode Durch Anfangs und Endzeitpunkt begrenztes Intervall Perioden werden unter eindeutigen Namen in einem separaten Datenbestand abgelegt und verwaltet PLANNED NET MODIFICATION Report In diesem Report werden Netze ausgewiesen die nach der Produktionspla nung ge ndert wurden PLAN START In der Planung vorgesehene Start Zeit des Netzes wird beim Planungsvorgang Namen
378. erfolgreich wenn das Kennwort mit dem bereinstimmt das beim Start der PLAM ZD mit RCS PASSWORD definiert wurde ENCRYPTION CODE Die Anweisung wird nur verarbeitet wenn ber die Generierungs Parameter PASSWORD ENCRYPTIONZYES eingestellt ist Wenn der Wert ge ndert wird k nnen die Netze im Produktions plan und in der Ablaufdatei nicht mehr verarbeitet werden c string Maximal 8 Zeichen lange Zeichenkette zur Verschl sselung der Kennw rter jvname Name einer Jobvariablen die eine maximal 8 Zeichen lange Zeichenkette zur Verschl sselung der Kennw rter enth lt Wenn die Jobvariable mit einem Lesekennwort READ PASSWORD gesch tzt ist muss in der Prozedur vorher das BS2000 Kommando ADD PASSWORD abgesetzt werden Hinweis Der AVAS Administrator muss sicherstellen dass der zentrale Zugriffsprozess ZDL und die Ablaufsteuerungen immer mit dem gleichen ENCRYPTION CODE gestartet wer den Die Netze k nnen sonst nicht verarbeitet werden U21462 J Z125 7 115 Starten und Beenden der AVAS Prozesse Administration von AVAS NET STATUS HOLD Wenn die Ablaufsteuerung nach einem harten Abbruch erneut gestartet wird f hrt sie f r ein Netz mit dem Status RUNNING intern die Funktion HOLD NET durch Diese Ma nahme verhindert dass nach einem Systemabbruch die Netzstruktur weiter verarbeitet wird ohne dass die erforderlichen Ressourcen im System bereitgestellt werden konnten RESUMED Beim Start der Ablaufsteuerung nach
379. erheits gr nden wird die AVAS Steuerungsinformation RV n RESTART VARIANT n in den Wert LR n LAST RESTART n ge ndert um eine ungewollte Restart Variante bei einem weiteren Restart zu verhindern U21462 J Z125 7 117 Starten und Beenden der AVAS Prozesse Administration von AVAS Startparameter zur Steuerung der Protokollverarbeitung Die folgenden drei Parameter sind nur anzugeben wenn die Ablaufprotokolle ber AVAS gespeichert werden sollen Es k nnen nur Protokolle gesammelt werden die im Inhaltsverzeichnis des AVAS Pools eingetragen sind Dies geschieht normalerweise im AVAS Job durch das Programm SIGNAL Wenn dazu im AVAS Job keine Vorkehrungen getroffen werden kann die Ablauf steuerung den Namen des Protokolls grunds tzlich im AVAS Pool eintragen Daf r ist der Startparameter GENERATE JOB LOG anzugeben GENERATE JOB LOG STD Ein Eintrag ins Inhaltsverzeichnis des AVAS Pools wird durch das Programm SIGNAL veranlasst ALL Ein Eintrag ins Inhaltsverzeichnis des AVAS Pools wird durch die Ablaufsteuerung f r jeden gestarteten Job erstellt F r den Namen wird NONE eingetragen JOBLOG NAME NONE Hinweis Wenn dieser Parameter beim Start der Ablaufsteuerung angegeben wird muss die ZD f r PLAM Zugriffe aktiv sein TRANSFER PROCEDURE NAME NONE Die Ablaufsteuerung soll keinen Folgejob f r TRANSFER starten dateiname Der Name einer Prozedur die von der Ablaufsteuerung mit dem BS2000 Kommando CALL P
380. ermeldung U21462 J Z125 7 314 BATCH Anweisungen CANCEL NET CANCEL NET Unterbrechen oder Abbrechen Netz wegen Fehlers Mit CANCEL NET kann die Verarbeitung von Netzen abgebrochen werden Der erforderli che Netzstatus vor Funktionsausf hrung und der gesetzte Netzstatus sind bei der Dialog funktion beschrieben CANCEL NET NET NAME S bk netname RUN CONTROL SYSTEM avak CANCEL TYPE SOFT HARD PERIOD NAME period jjmmtt hhmmss jjmmtt hhmmss KILL JOBS NO YES Der Parameter NET NAME muss angegeben werden der Parameterwert kann teilqualifi ziert angegeben werden Wenn der Parameter RUN CONTROL SYSTEM nicht angegeben wird wird der Name der Ablaufsteuerung ber die Anmeldedaten ermittelt Wenn der Parameter CANCEL TYPE nicht angegeben wird wird der ber die Generie rungs Parameter festgelegte Standardwert gesetzt Der Parameter PERIOD NAME ist nur in Verbindung mit einem teilqualifizierten Netzna men zugelassen Wenn der Parameter KILL JOBS nicht angegeben wird gilt standardm ig die Einstellung NO Protokoll der Verarbeitung F r jedes abgebrochene Netz wird AVS8521 CANCEL NET netname RESULT ergebnis ausgegeben oder eine Fehlermeldung U21462 J Z125 7 315 CHANGE NET DESCRIPTION BATCH Anweisungen CHANGE NET DESCRIPTION Massen nderung von Netzen Mit CHANGE NET DESCRIPTION k nnen einige Parameter von Netzen in der Benutzer bibliothek NETLIB ge ndert werden D
381. ermeldungen von MARENAV 6 3 8 Warnungsmeldungen von MARENAV TEEN ROTEN TORTE STE UT 7 ASR S ein 11 7 1 REPORTGenerator u RE RURAL Ed ein 284 TA Eingabe der REPORT Anweisungen f r den REPORT Generator m 285 7 1 2 Ausw hlen der Funktionen des REPORT Generators 286 7 1 3 Zuordnung des Produktionsplans und der Journaldatei SEN Ke 22 286 7 1 4 Zuordnung der Arbeitsdatei f r den REPORT Generator 286 715 Zuordnung der Reportdatei f r den REPORT Generator 287 7 1 6 Ausgaben des REPORT Generators in die Arbeitsdatei UT 287 TX Ausgaben des REPORT Generators in die Reportdatei Do 7 1 8 Zuordnung der Ein Ausgabedatei bei FUNKTIONZSORT m 207 7 2 PEPORTANWelsUNgen vu 2er 289 AVAS SYSTEM ID Ausw hlen des AVAS S 289 AVAS USER ID Ausw hlen des Produktionsplans erh ME END Beenden der Anweisungsfolge an den REPORT Generator den saxe 290 FUNKTION Ausw hlen der Funktionen des REPORT Generators 290 NET NAME Ausw hlen der Netze ber den Netznamen zw 291 OUTPUT REPORT FILE Zuordnen BS2000 Dateiname f r Reportdatei 292 OUTPUT REPORT LINK Zuordnen einer Reportdatei ber Kettungsname 293 OUTPUT WORK FILE Zuordnen BS2000 Dateiname f r Arbeitsdatei sess 294 OUTPUT WORK LINK Zuordnen einer Arbeitsdatei ber Ket
382. ern in der Konfigurationsdatei m ssen dann jeweils mit der Portnummer f r die Benutzer kennung bereinstimmen e AVSRECV l uft als Hintergrundprozess damit die Dialogstation frei bleibt AVSRECV protokolliert seine Aktionen in der Protokolldatei avs prot Pfad siehe Datei Setup avs UNIX System oder Registrierungsdatenbank Windows System e AVSRECV wird normal beendet wenn er das Signal 2 oder 15 erh lt Beispiel ps fu userid liefert die Prozessnummer pid des AVSRECV kill 2 pid beendet AVSRECV oder mit etc rc2 d S99avas kennung stop e Der Benutzer muss f r den Pfad der ber die Konfigurationsdatei vorgegeben ist die Berechtigungen read write und execute zulassen Skript Dateien rwx f r AVSTRT erforderlich JV Dateien rw f r AVSTRT und AVSSINJV erforderlich 11 3 4 2 Beenden des AVAS Servers AVSRECV Der AVAS Server AVSRECV wird auf dem Server System folgendermaBen beendet etc rc2 d S99avas kennung stop 474 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs 11 3 4 3 bergabe der Parameter an Server Jobs f r UNIX Plattform Die Regeln zum Formulieren von Parametern f r Server Jobs sind im Handbuch AVAS Funktionen 2 beschrieben Beispiel Der Server Job wird wie alle von AVAS verwalteten Jobs in der JCLLIB der AVAS Kon figuration auf der BS2000 Seite gespeichert Die Kommandofolge sowie die Parameter k nnen mit EDIT JOB b
383. ern 186 Protokoll Datens tze 140 Satzl nge 141 Protokolleintr ge sichern 186 Status 140 387 138 138 139 166 U21462 J Z125 7 Stichw rter Not Journaldatei einrichten 26 JRLDAT 55 Not Journale einmischen NPRLIB 54 163 535 NPRnnn 25 128 0 Operand MACID Generierung von Namen 9 MF Code Generierung 389 PREFIX Generierung von Namen Operation 5 Beendigung Zugriffsprozesse 128 Verwaltung angemeldeter Benutzer Optimierung Batch Betrieb 158 OUTAREA 2 OUT OF PLAN Report 281 535 OUTPUT FILE Reorganisationsanweisung OUTPUT LINK Reorganisationsanweisung 389 127 178 179 P P4 44 Parameter allgemeine Benutzer 1 Parametrisieren von Server Jobs 65 UNIX Pattform 475 Windows Pattform 482 PASSWORD ENCRYPTION 23 PDN Datenstationstyp falsch 67 PERDAT 24 53 163 535 Periode 535 Datum variabel 322 mit Ersatzzeichen 320 variable reale Daten variable erstellen 320 Periodendatei PERDAT 53 PERIOD NAME Reorganisationsanweisung PLAM ZD 53 PLANNED NET MODIFICATION Report 535 PLAN START 535 Planungsintervall 535 Platzhalter 323 178 281 554 Stichw rter START 180 USER PASSWORD 180 ZDD PASSWORD 180 ZDL PASSWORD 181 Reorganisationsprozedur 4 REPEAT NET BATCH Anweisung 338 REPORT Anweisungen 536 bersicht 283 REPORT Generator 281 536 Ablauf 284 Ressourcenpfad AVAS DOORS 65 Restart automatischer 527 Restart Anweisung 536 RESTART INDEX 536 Restart
384. ersichtsverarbeitung mit Markierung S oder AVPO001 vollqualifizierter Parameter NET NAME CREATE PROD NET ExECUTE Die Serialisierung wird erst bei der mit SAVE bzw AVM001 EXECUTE eingeleiteten Verarbeitung belegt Wenn die Serialisierung nicht belegt werden kann SUBMIT NET SAVE MAX SERIAL WAIT wird die Verarbeitung f r das Netz AVFOO2 abgebrochen und die Meldung AVS5804 ausgegeben AVF004 REPEAT NET SAVE AVFO12 AVFO14 RCS PASSWORD STD Bei der Anmeldung der Ablaufsteuerungen wird das intern festge legte Kennwort erwartet Qu gt Die Ablaufsteuerungen m ssen sich mit dem angegebenen Kenn wort bei den Zugriffsprozessen anmelden Wenn RCS PASSWORD nicht eingegeben wird wird STD angenommen U21462 J Z125 7 111 Starten und Beenden der AVAS Prozesse Administration von AVAS REO PASSWORD STD Bei der Anmeldung der Reorganisation wird das intern festgelegte Kennwort erwartet Kiss Die Reorganisation muss sich mit dem angegebenen Kennwort bei den Zugriffsprozessen anmelden Wenn REO PASSWORD nicht eingegeben wird wird STD angenommen Beim Hochfahren der UPAM ZD werden Not Journaldateien aus fr heren Sitzungen auto matisch in die Journaldatei bertragen W hrend der laufenden Sitzung kann der Admini strator die bertragung veranlassen indem er den String IN JRLDAT in die Jobvariable zur berwachung der UPAM ZD eintr gt Normales Beenden der Zugriffsprozesse
385. erufen werden weil der Aufruf direkt in den Jobs erfolgt 468 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs 11 3 3 Aufbau der Auftrags Jobvariable und der Server JV Datei Die Inhalte der Auftrags Jobvariablen und der Server JV Datei sind in den ersten 128 Byte durch das BS2000 OSD vorgegeben Die brigen Stellen werden AVAS spezifisch verwen det Die Auftrags Jobvariable bzw die Server JV Datei hat folgenden Aufbau Byte L nge Info gesetzt von 1 2 Status von AVSSINCM BS2000 0SD 129 55 AVAS User Bereich Server Job 184 Status des Server Jobs CAVSSINCM AVSSTRT 185 1 Zusatzstatus des Server Jobs CAVSSINCM 186 10 pid des AVSSTRT AVSSTRT 196 Jobtyp CAVSSINCM 197 4 Exit Code des Server Jobs CAVSSTRT 201 4 Fehlermeldungsnummer CAVSSINCM 205 2 Fehlerschl ssel in Meldung CAVSSINCM 207 1 Modus des AVSSINCM CAVSSINCM 208 16 Hostname des Server Rechners CAVSSINCM 224 8 Server Name CAVSSINCM Byte 1 2 Status des Prozesses AVSSINCM nach BS2000 OSD S Prozess gestartet R Prozess l uft T Prozess normal beendet A Prozess abnormal beendet Byte 184 SV Status Status des Server Jobs S Server Job startbereit nach Datei bertragung R Server Job angelaufen T Server Job normal beendet A Server Job abnormal beendet E AVSSINCM hat die Verbindung zum AVAS Server vor Ende des Server Jobs verloren oder das Programm avasr3 hat die Verbin
386. erungsspalte 533 Makro AVASEXKO 78 AVASJRN 187 AVASNET 347 AVASNET Aufl sungen 350 AVEXSVV 76 MAPLIB 54 MAPnnn 31 163 MARENAV 259 einbinden 76 Meldungen 277 MAREN Kopplung mit AVAS 259 Maskenbibliotheken MAPLIB 54 MAX BATCH PROCESS 23 Meldungen MARENAV 277 Meldungsdateien 104 MFHSROUT Datei 67 MODIFY COND DESCRIPTION BATCH Anweisung 335 Programmschnittstelle 373 Modul AVO3EXTV 76 MARENAV 259 MONJV PASSWORD 114 MONJV RDPASS 114 mscf control time 36 MSG7 DEST DIALOG 24 mySAP com RFC Schnittstelle 496 mySAP com Benutzerdaten 497 mySAP com Jobs 494 mySAP com System Ausfall 516 mySAP com Zugriff Konfiguration 496 U21462 J Z125 7 SCR 5 VOL 3 Pr fix Not Journaldatei 26 privilegierter Benutzer 33 Produktionsdurchf hrung 2 Produktionsfreigabe 2 Produktionsjobbibliothek 2 Produktionsjobs Bibliotheken 54 Produktionskontrolle 2 Produktionsnetzbibliothek 32 NPRLIB 54 Produktionsplan 2 536 Definition 32 Produktionsvorbereitung 2 Programm AVSSINJV 492 SIGNAL 137 TRANSFER 137 Programmschnittstelle 373 Anweisungen 373 Arbeitsbereich 380 Aufruf Assembler 386 Aufruf Cobol 418 Beispiel in Assembler Beispiel in Cobol 419 Ergebnisbereich 380 Kommunikationsbereich 380 Protokoll als Datensammlung als JOBLOG Satz bearbeiten 153 Inhaltsverzeichnis Satz 138 Optimierungsma nahmen zum Sammeln 151 Protokollmeldung Satz sammeln 141 speichern 137 Protokolldatei Reorganisation Protokolldaten sich
387. erver berwachung werden die Konfigurationsdatei gelesen und die SV JVs entsprechend versorgt Die Server berwachung erzeugt eine SV JV wenn es die se f r einen zu berwachenden Server noch nicht gibt Danach wird der Zustand der AVAS Server ermittelt Die Server berwachung schickt Nach richten an die zu berwachenden Server und wartet auf deren Antworten Sendet der angesprochene Server eine Antwort wird in der zugeordneten SV JV der Wert R eingetragen Bleibt die Antwort aus erh lt die SV JV den Wert T Zyklische berpr fung der Server Die Server werden beim Starten der Server berwachung berpr ft Diese berpr fung wird zyklisch wiederholt anhand der mit dem Operanden SV CONTROL TIME einzustellen den Zeitspanne Wenn Server neu in der Konfigurationsdatei eingetragen oder aus ihr entfernt werden kann mit der Operation CONFIG an die Server berwachung die zu berwachende Serverumge bung aktualisiert werden siehe Operation zur Aktualisierung der Serverumgebung auf Seite 491 Die nderung ist der Ablaufsteuerung ber den Aufruf INFORM PROG MSG SERVER JOB ID tsn oder das Versorgen der Jobvariablen der Ablaufsteuerung mit USERVER mitzuteilen 488 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs Starten der Server berwachung Die Server berwachung ben tigt ber SYSDTA folgende Eingabeparameter lt file name 1 54 gt Name
388. erzeichnis geschrieben werden U21462 J Z125 7 452 AVAS SV Plattform bergreifende Jobsteuerung Deinstallation der AVAS Server 11 2 3 Deinstallation von AVAS SV BS2 auf einem BS2000 System Bei der Deinstallation eines AVAS Servers auf einem BS2000 System werden unter der Benutzerkennung unter der AVSRECV gestartet wurde folgende AVAS Bibliotheken und Protokolldateien entfernt SYSMES AVAS 070 SYSPRC AVAS 070 SYSPRG AVAS 070 SYSTEM SYSPRG AVAS SV BS2 070 U21462 J Z125 7 453 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung 11 3 Ablaufsteuerung und kontrolle von Server Jobs F r die Kommunikation mit dem Server System startet die Ablaufsteuerung den AVAS Agenten AVSSINCM Er sorgt f r die bertragung des Server Jobs falls der Server Job in AVAS gespeichert ist f r dessen Start im Server System die berwachung seines Ablaufs das bermitteln des Ergebnisses an die Ablaufsteuerung sowie die bernahme der Log Dateien Im Server System muss vorher der AVAS Server AVSRECV gestartet sein Nach seinem Start baut AVSSINCM eine Verbindung zu AVSRECV auf bertr gt den Ser ver Job und erteilt den Startauftrag Den Status der eingehenden Quittungen schreibt er in seine berwachende Auftrags Jobvariable sodass die Ablaufsteuerung bei der Anweisung SHOW NET STATUS den Status des Server Jobs erkennen kann AVSSINCM l uft unabh ngig von der Ablaufsteuerung und beendet sich
389. es Netz besteht mindestens aus den Datens tzen N1 N2 N3 N4 und N5 in der ange gebenen Reihenfolge F r jedes Strukturelement m ssen drei Datens tze angelegt werden Der Datensatztyp ist abh ngig von der Funktionalit t des zu definierenden Strukturele ments U21462 J Z125 7 347 Externe Erstellung von AVAS Elementen FUNCTION Datensatz J Job J1 J2 J3 P Procedure X Server JOB C Compare C1 C2 C3 A Add A1 A2 A3 M Modify M1 M2 M3 D Delete D1 D2 D3 W Wait W1 W2 W3 S Start S1 S2 S3 Externe programmtechnische Erstellung von Netzen Die Datens tze m ssen in der angegebenen Reihenfolge angelegt werden Satz1 Satz2 Satz3 Die Datens tze der Strukturelemente m ssen nach INDEX aufsteigend sortiert sein Bei mehreren Strukturelementen auf einer Indexstufe gilt die vorgegebene Reihenfolge Allgemeine Form des Makroaufrufs Parameter MF C D PREFIX N char 1 gt MACID RECORD char 3 gt RECORD N1 N2 NS NA N5 J1 J2 J8 C1 C2 C3 51 52 53 A1 A2 A3 M1 M2 M3 D1 D2 D3 3 Der Parameter MF steuert die Code Generierung Makroform Das Layout der Datenstruktur in der Regel der Parameterbereich wird erzeugt wobei jedes Feld und jedes Equate benannt sind Diese Daten struktur wird Teil des aktuellen Programmabschnitts CSECT DSECT Erzeugt das Layout der Datenstruktur wie bei MF C zus tzlich wird ein DSECT Statement erzeugt Der Param
390. ese Kennw rter werden in der NPRLIB und der ABLDAT verschl sselt Die Kennw rter in den Netzen in der NETLIB werden nicht verschl sselt weil diese Biblio thek als Export Import Schnittstelle zu anderen AVAS Systemen fungiert COP Y ELEMENT Der Benutzer kann die Netze auf mehrere NETLIBs verteilen womit selbst Berechtigte keinen Zugriff auf alle Netze haben Die Verschl sselung der Kennw rter in der NPRLIB und in der ABLDAT erfolgt im zentralen Zugriffsprozess ZDL die Entschl sselung in den Ablaufsteuerungen U21462 J Z125 7 19 Generierung des AVAS Systems Installation und Generierung Der geheime Schl ssel ENCRYPTION CODE muss dem Prozess ZDL und beim Start der Ablaufsteuerung AVAK als Startparameter mitgegeben werden siehe Seite 109 und U21462 J Z125 7 Seite 115 Systemstruktur CLASS 2 OPTION ENCRYPT Y BS2000 OSD BS2000 OSD BS2000 OSD USERID 1 USERID 2 USERID 3 PASS ENC YES PASS ENC YES PASS ENC YES ENCRYPTION ENCRYPTION CODE CODE Dialog ZDL AVAK task Prozess Prozess NET CRYPT CRYPT PASSW Verschl sse Entschl sse PASSW gt PASSC gt PASSC PASSC gt PASSC gt PASSW PASSW PASSC NPRLIB NETLIB ABLDAT JRNDAT Bild 1 Systemstruktur Installation und Generierung Generierung des AVAS Systems NETLIB Die Kennw rter in der NETLIB werden nicht verschl sselt NPR
391. esen wurde wird die Verlagerungsprozedur mit einer Variablen amp TEMPLOC erstellt Die Spalte TO LOC in der Transport und Bandmontierliste bleibt leer Damit entf llt bei allen AVAS Installationen ohne MRS Umgebung die Notwendigkeit eine Lagerortdatei zu erstellen Wenn in diesem Fall an MARENAV verschiedene CATIDs bergeben werden wird in die Verlagerungspro zedur eine REMARK Zeile mit folgendem Text aufgenommen WARNING DIFFERENT CATIDS USED DURING SUBMIT Dies soll darauf hinweisen dass die in dem Netz verwendeten Datentr ger m glicherweise nicht nur an einem Rechner verarbeitet werden und somit f r die Prozedurvariable amp TEMPLOC auch unterschiedliche Lagerorte anzugeben w ren In folgenden F llen wird die Produktionsfreigabe abgebrochen e Die Lagerortdatei wurde zwar zugewiesen konnte jedoch nicht er ffnet werden oder bei ihrer Verarbeitung trat ein DVS Fehler auf e Ein Lagerort ist nicht vom Datentyp alphanumerisch e F reine an MARENAV bergebene CATID befand sich kein Eintrag in der Lagerort datei U21462 J Z125 7 268 Kopplung AVAS mit MAREN Erstellen von Datentr gerlisten 6 3 1 Transportliste Diese Datei hat den Namen TRS AVAS rcs yymmdd hhmmss rcs Name des Ablaufsteuerungssystems yymmdd hhmmss Datum und Uhrzeit der Produktionsfreigabe Diese Datei enth lt eine Liste aller zu einem Netz geh renden VSNs inklusive der Daten tr ger die nur im Restart Fall ben tigt werden S
392. et Wenn der Parameter fehlt oder den Wert STD hat wird der Name der Ablaufsteuerung angenom men siehe Seite 119 Entgegen anderer AVAS Prozesse ist der Name der kontrollierenden Jobvariablen f r die Server berwachung nicht in den Generierungsparametern gef hrt Er muss als Parameter beim Aufruf des Server berwachungsprogramms AVAS SYS LOAD SVDOG mitgegeben werden Beim Starten des AVAS Systems d rfen die Ablaufsteuerungen erst starten nachdem die AVAS Server berwachung die SV JVs auf den aktuellen Stand gebracht hat Andernfalls kann es passieren dass Server Jobs bereits gestartet werden sollen die zugeh rige SV JV aber noch nicht versorgt ist sodass der Server Job den Status ERROR erh lt F r eine Synchronisierung mit anderen Prozessen legt die Server berwachung Statusin formation in der sie kontrollierenden Jobvariablen ab Diese SV JV kann analog zu den an deren AVAS Prozessen ab Spalte 2 folgende Werte in der Lange 10 enthalten STARTING1 Programmparameter werden bearbeitet die Konfigurationsdatei wird ge lesen STARTING2 SV JVs werden eingerichtet bzw gel scht STARTINGS Server Status werden ermittelt READY SV JVs sind aktualisiert RUNNING Die Konfigurationsdatei wird neu eingelesen und oder die Server Status werden erneut ermittelt U21462 J Z125 7 121 Starten und Beenden der AVAS Prozesse Administration von AVAS ENDING SV JVs werden zur ckgesetzt d h sie erhalten den Wert U ENDED Der
393. eter PREFIX dient zum Generieren der zu erzeugenden Namen PREFIX der genau ein Buchstabe ist wird als erster Buchstabe aller Namen verwendet Default Wert ist der Kennbuchstabe der Funktions einheit dem der Makro angeh rt Um Namensgleichheit zu vermeiden ist PREFIX zu verwenden wenn dieselbe Datenstruktur mehrfach innerhalb eines Moduls verwendet wird U21462 J Z125 7 Makro AVASNET MF o D PREFIX Externe Erstellung von AVAS Elementen Externe programmtechnische Erstellung von Netzen Wenn MACID nicht angegeben wird ist f r PREFIX ein 2 Zeichen langes Pr fix zul ssig Der Parameter MACID dient zum Generieren der zu erzeugenden Namen Er bestimmt die auf PREFIX folgenden Zeichen des Namens Der Default Wert garantiert die Kollisionsfreiheit der Namen innerhalb der Komponen tengruppe Feldnamen und Equates enthalten an der zweiten und dritten Zeichenstelle den bei RECORD angegebenen Wert 3 Zeichen lange Zeichenfolge die das zweite bis vierte Zeichen der vom Assembler generierten Feldnamen und Equates beschreibt Anzeige f r welchen Netzbeschreibungssatz Definitionen generiert werden sollen Die anschlie enden Makroaufl sungen beschreiben den Inhalt der S tze Definiert die Netzbeschreibungss tze 1 2 3 mit den symbolischen bzw realen Startterminen und den zugeordneten Planungs Parametern Definiert den Netzbeschreibungssatz 4 mit den Netzparametern Def
394. f der Indexstufe 030 wurde nicht f r die Verarbeitung geplant Die Netzverarbeitung wurde ber HOLD NET beim Index 040 unterbrochen Das Strukturelement auf der Indexstufe 050 wurde bei SUBMIT NET nicht freigegeben es wurde von der Ablaufsteuerung noch nicht bearbeitet weil HOLD auf Indexstufe 040 Das Strukturelement auf der Indexstufe 060 wurde mit MODIFY SUBMIT NET gel scht es wurde von der Ablaufsteuerung noch nicht bearbeitet weil HOLD auf Indexstufe 040 Wenn Index 060 bearbeitet wird wird HOLD gesetzt U21462 J Z125 7 399 Assembler Schnittstelle Programmschnittstelle von AVAS AVSASSBC Kommunikationsbereich definieren Makro Parameter AVSASSBC MF C D PREFIX A char 1 gt MACID VSR char 3 gt Parameter MF und PREFIX siehe AVSASSAD auf Seite 389 MACID Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Er bestimmt das zweite und dritte Zeichen des Namens Das vierte Zeichen wird je nach Typ mit R C oder Q belegt Der Standardwert garantiert die Kollisionsfreiheit der Namen innerhalb der Komponentengruppe Aufl sung des Makros AVSASSBC AVSASSBC MFCHK MF C PREFIX A MACID VSR DMACID VSR SUPPORT C D DS or AHHHHE PREFIX A MACID VSR Z AVAS BATCH PROGRAM INTERFACE COMMUNICATION AREA RETURN AREA AVSRAREA DS 212 AVSRCMDT DS CL24 CMD TEXT AVSRFDBK DS OAL2 RETURN CODE FEEDBACK CODE1 AVSRFDBl DS ALL FEEDBACK 1 AVS
395. fad C Program FilesXSiemensN amp VAS NT vas 5v Arbeitsverzeichnis Evavaswork Portnummer Passwort weess 00000000000000 0 Protokolldatei Cvavasvworkvavslogtst Hilfe Abbrechen Bild 9 Fenster zur Anzeige und Anderung der Ablaufparameter des Windows Dienstes AvasService U21462 J Z125 7 479 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung 11 3 5 4 Schnittstelle von AVAS SV zur Benutzerverwaltung auf Windows Systemen Auf Windows Systemen ist es m glich Jobs unter einer bestimmten Kennung ablaufen zu lassen f r die ein Benutzerkonto eingerichtet ist Die Benutzerkennungen unter denen Jobs auf Windows Systemen gestartet werden d rfen m ssen mit ihren Kennw rtern im System eingetragen sein Das Eintragen der erlaubten Kennungen mit ihren Kennw rtern wird mit der Funktion Schaltfl che Benutzer des Programms AVAS Konfiguration durchgef hrt Jede Benutzerkennung ben tigt zudem einen entsprechenden Eintrag in der AVAS Konfi gurationsdatei des BS2000 OSD Wenn Jobs ohne Pr fung von Kennung und Kennwort gestartet werden sollen ist in der Konfigurationsdatei des BS2000 OSD die Kennung SYSTEM einzutragen Der Job wird mit dem Systemkonto gestartet Wenn die Protokolldatei nicht mit vollem Dateinamen angegeben wird wird sie unter lt windir gt system32 abgelegt Anlegen der Benutzerkennungen f r den AVAS Server Nach Starten des Programms AVAS Konfigurati
396. fs mit Kontrolle durch eine BS2000 Server System steuerung BS2000 OSD mit AVAS Server Systeme AVAS Ablauf steuerung AVAS JV Schnittstelle ENTER PROCEDURE PROC PAR crtl jva name jva passw job parameter USER Prozedur mit Interface zur Server System Steuerung crtl jva name jva passw job parameter Server System steuerung Steuerung mit AVAS JV 4 oder ST Schnittstelle au nach Server System BS2000 AVAS Konventionen T A RV n Hinweis Der Start der Prozedur f hrt zur Vergabe einer TSN Task Sequence Number des BS2000 OSD die in der Ablaufdatei und der Journaldatei abgelegt wird U21462 J Z125 7 525 AVAS Schnittstelle f r externe Server AVAS SV Plattform bergreifende Jobsteuerung Die TSN ist Bestandteil des Ordnungsbegriffes der JOBLOG Protokollierung und wird dort angezeigt Das BS2000 OSD tr gt die TSN nicht in die Jobvariable ein da es in diesem Fall keine Auftrags Jobvariable ist Der Benutzer hat zu ber cksichtigen dass bei der JOBLOG Protokollierung und bei der Anzeige durch SHOW NET STATUS und SHOW JOURNAL die gespeicherte TSN ver wendet wird Dies gilt im besonderem Ma e wenn an einem Ablauf mehrere Prozesse beteiligt sind Wenn Ereignisse von AVAS an das Server System signalisiert werden sollen kann dies nur ber den Start von Jobs und Prozeduren erfolgen vorrangig FUNCTION P TYPE EXX wo
397. fsteuerung ber die Anmeldedaten ermittelt Protokoll der Verarbeitung F r jedes unterbrochene Netz wird AVS8521 RESUME NET netname RESULT ergebnis ausgegeben oder eine Fehlermeldung U21462 J Z125 7 341 SIGNON SUBMIT NET BATCH Anweisungen SIGNON Beginn der Folge der BATCH Anweisungen Die BATCH Anweisung SIGNON muss am Anfang einer Verarbeitungsfolge stehen Die Parameter entsprechen den Eingabefeldern in der Maske AVSO10 SIGNON AVAS USER ID avuser PASSWORD kennwort AVAS SYSTEM IDsstring Protokoll der Verarbeitung AVS2501 BITTE KOMMANDO EINGEBEN oder es wird eine Fehlermeldung ausgegeben SUBMIT NET Freigabe geplanter Netze Bei der BATCH Anweisung SUBMIT NET wird der Parameter OBJECT nicht unterst tzt Die Netzparameter k nnen bei der Freigabe der Netze ber die BATCH Funktion nicht ge ndert werden SUBMIT NET PERIOD NAME periog NET NAME bk netname Der Parameter PERIOD NAME ist nur in Verbindung mit einem teilqualifizierten Netzna men zugelassen Protokoll der Verarbeitung F r jedes freigegebene Netz wird AVS8521 SUBMIT NET netname RESULT ergebnis ausgegeben oder eine Fehlermeldung 342 U21462 J Z125 7 BATCH Funktionen Prozeduren und Bibliotheken f r die BATCH Funktionen 8 2 Prozeduren und Bibliotheken f r die BATCH Funktionen Prozeduren F r den Ablauf der BATCH Funktionen ist die Bibliothek SYSPRC AVAS 070 mit dem J Element AVS BATCH vorhanden die als Beispiel
398. g R ckgabe der RZ Routine an AVAS Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden Die JCL Anweisung wurde nicht ge ndert Im Journal erfolgt kein Eintrag Die ge nderte JCL Anweisung ist von AVAS zu bernehmen Diese R ckgabe ist nur m glich wenn eine JCL Anweisung bergeben wurde Im Journal werden zwei S tze eingetragen 25 01 Datensatz mit dem alten Inhalt 25 02 Datensatz mit dem neuen Inhalt Die RZ Routine konnte die JCL Modifikation nicht durchf hren AVAS beendet die Anweisung mit ERROR Im Journal wird der Satz bei dem abgebrochen wurde unter der Nummer 25 01 eingetragen Im bergabebereich f r JCL Anweisungen kann zus tzlich ein Text bergeben werden der im Journal unter der Nummer 25 05 eingetragen wird Die ge nderte JCL Anweisung ist von AVAS zu bernehmen Die ge nderte JCL Anweisung ist ein Block von JCL Anweisun gen mit variablen Satzl ngen d h die Felder pfixJRLG pfixJRES und pfixJRSE wiederholen sich bis pfixJRLG gleich X 0000 ist Diese Wiederholung ist maximal nur bis zu der L n ge erlaubt wie sie im Feld pfixLEN angegeben ist Die tats chliche L nge der R ckgabe im Feld pfixLFU muss von dem Feld pfixNNAM bis zur letzten JCL Anweisung reichen Die se R ckgabe ist nur m glich wenn eine JCL Anweisung ber geben wurde Im Journal werden zwei S tze eingetragen 25 01 Datensatz mit dem alten Inh
399. g von avasr3 in die AVAS Jobsteuerung Der Start von Jobs f r mySAP com aus AVAS heraus erfolgt wie bei anderen plattform ber greifenden AVAS Jobs Strukturelemente mit FUNCTION X starten ber den AVAS UNIX und Windows Agenten AVSSINCM Prozesse auf dem UNIX oder Windows Partnerrech ner Dazu muss lediglich die Adresse und die Portnummer f r die Kommunikation in die Konfigurationsdatei eingetragen werden Die Zugangsberechtigung zum AVAS Server AVSRECV f r UNIX bzw AVAS Dienst AVAS SV f r Windows Systeme wird ber das Kennwort gepr ft das unter COMM PW in der Konfigurationsdatei angegeben ist Das Programm avasr3 muss innerhalb des UNIX bzw Windows Jobs mit den entsprechen den Parametern aufgerufen werden Voraussetzung f r die erfolgreiche Kommunikation von AVAS mit mySAP com ist die ordnungsgem e Installation und der Start von AVS RECV Zur R ck bertragung von Ergebnissen ins BS2000 OSD stehen dem Anwender die zu AVAS SV geh renden Programme avssinjv und avslog zur Verf gung e Mit avssinjv kann der Exit Code eines avasr3 Aufrufs bertragen und in der Job variablen angezeigt werden MONJV VALUE e Mitavslog kann die durch avasr3 erstellte LOG Datei die im Normalfall das mySAP com Job Protokoll enth lt ins BS2000 OSD bertragen werden U21462 J Z125 7 495 Steuerung von SAP R 3 Jobs mit AVAS AVAS SV Plattform bergreifende Jobsteuerung Installation und Konfiguration Installation avasr3 wird i
400. g wird nur ben tigt bei Verwendung von Server Jobs Er muss vor der Ablaufsteuerung gestartet werden Sicherheit im AVAS System Um zu verhindern dass sich unberechtigte Prozesse als zentraler Zugriffsprozess als Ablaufsteuerung oder als Reorganisationsprozess laden oder anmelden Prozedur AVS REORG in der Bibliothek SYSPRC AVAS 070 siehe Seite 163f kann der AVAS Administrator in den Prozeduren Kennworte vergeben mit denen die Zusammengeh rig keit der Prozesse festgelegt wird Die Kennw rter werden ber SYSDTA in der Initialisierungsphase der jeweiligen Prozesse gelesen und gepr ft Eine fehlerhafte Eingabe f hrt zur Beendigung des Prozesses 104 U21462 J Z125 7 Administration von AVAS Starten und Beenden der AVAS Prozesse Die Voraussetzungen f r einen Start der zentralen Zugriffsprozesse sowie die Vorgehens weise bei der Beendigung sind nachfolgend beschrieben Ausgeben von Diagnoseunterlagen SYS ADUMP Beim Auftreten von unerwarteten Fehlern werden Diagnoseunterlagen in die Datei mit dem Pr fix SYS ADUMP ausgegeben Dies gilt f r den AVAS Dialogprozess und f r die AVAS Ablaufsteuerung Wenn in AVAS ein Fehler auftritt der zu einer Problem Meldung f hrt muss gepr ft wer den ob in diesem Fall Diagnoseunterlagen in eine Datei mit dem Pr fix SYS ADUMP aus gegeben wurden Diese sind dann mit der Problem Meldung zu bergeben U21462 J Z125 7 105 Starten und Beenden der AVAS Prozesse Admini
401. ge k nnen damit von au en angesto en werden U21462 J Z125 7 11 5 1 11 5 2 494 AVAS SV Plattform bergreifende Jobsteuerung Steuerung von SAP R 3 Jobs mit AVAS Externe Job Management Systeme k nnen die Funktionen der XBP Schnittstelle remote ber ein RFC Client Programm verwenden RFC steht f r Remote Function Call Auch AVAS verwendet diese XBP Schnittstelle das Programm avasr3 ist das RFC Client Pro gramm f r die Anbindung von AVAS an mySAP com Mit avasr3 ist es damit m glich mySAP com Jobs voll in die Automatisierung mit AVAS ein zubeziehen D h mySAP com Jobs k nnen integriert mit beliebigen anderen Jobs sys tem und plattform bergreifend in einem Jobnetz laufen Bestimmte Abl ufe wie z B das Warten auf die Beendigung eines vorhergehenden Jobs oder das Reagieren auf Ereignisse au erhalb von mySAP com lassen sich mit AVAS und avasr3 leichter steuern als innerhalb des Systems mySAP com Die von avasr3 gestarteten mySAP com Jobs sind auch im mySAP com Dialog ber das CCMS anzeigbar mySAP com Transaktion SM37 Ein RFC Client Programm muss sich unter einem bestimmten mySAP com Benutzer am mySAP com System anmelden Da durch werden auch die Berechtigungspr fungen von mySAP com durchlaufen und es ent steht keine Sicherheitsl cke Das Programm avasr3 bietet zudem die M glichkeit mit einem mySAP com Job eine mySAP com Sicherung zu starten und offline auf deren Ende zu warten 11 5 3 Einbindun
402. geben wird wird STD ange nommen Hinweis Die Anmeldung von CENTRAL an der PLAM ZD ist nur dann erfolg reich wenn das Kennwort mit dem bereinstimmt das beim Start der PLAM ZD mit CENTRAL PASSWORD definiert wurde Damit CENTRAL die Protokolle direkt bernehmen kann sollten vor dem Aufruf des CENTRAL Prozesses in der Prozedur AVS CENTRAL f r die Sekund rtasks die Kenn w rter f r die Protokolldateien der Anwendungsprozesse definiert werden BS2000 Kommando ADD PASSWORD Beenden des CENTRAL Prozesses Der CENTRAL Prozess kann normal oder abnormal beendet werden Normale Beendigung Der CENTRAL Prozess wird durch Setzen des Strings SHUTDOWN in die zugeordnete Jobvariable veranlasst die Beendigung durchzuf hren Der Name der Jobvariable ist in den System Parametern eingetragen Der einzelne Sekund rprozess beendet sich nur wenn kein Auftrag mehr bearbeitet wird Wenn sich alle Sekund rprozesse beendet haben wird auch der Prim rprozess geschlos sen U21462 J Z125 7 143 Administrationsaufgaben im Betrieb Administration von AVAS Abnormale Beendigung Ein nicht behebbarer Prozessfehler Programm bzw Makrofehler f hrt zur Ausgabe eines Speicherauszugs und einer Fehlermeldung Wenn der Fehler in einem Sekund rprozess auftritt wird nur der betroffene Prozess been det In diesem Fall ist es m glich mit der Startprozedur einen neuen Sekund rprozess zu starten Ein Fehler in der Prim rtask f hrt
403. geladen werden kann Die Kommandos entsprechen in ihrer Wirkung den ber die Dialogkomponente m glichen Anweisungen Es sind jedoch bei einigen Aufrufen weniger Parameter und damit weniger Einfluss oder Einsichtnahme m glich Das gilt insbesondere f r alle eine Ablaufsteuerung bergreifenden Eingaben da alle INFORM PROG Kommandos sich nur auf die Steuerung der unter der betroffenen Ablaufsteuerung laufenden Netze beziehen Die Eingabe der Anweisung erfolgt ber das BS2000 Kommando INFORM PROG Der formale Aufbau ist INFORM PROG MSG anweisung JOB ID lt tsn gt anweisung ist eine der nachfolgenden Anweisungen des AVAS Systems e tsnist die Task Sequence Number der Ablaufsteuerung unter dem Betriebssystem e tsn und anweisung werden als Zeichenfolge an eine STXIT Routine des AVAS Systems bergeben bersicht der INFORM PROG Kommandos zum Steuern der Netzabl ufe INFORM PROG CANCEL NET Ablaufendes Netz abnormal beenden INFORM PROG HOLD NET Ablaufendes Netz anhalten INFORM PROG RESTART NET Abnormal beendetes Netz wieder starten INFORM PROG RESUME NET Angehaltenes Netz wieder starten INFORM PROG SHOW NET STATUS Status der ablaufenden Netze anzeigen INFORM PROG START NET Netze im Status OPWAIT starten Die Anweisungen k nnen nach den gleichen Regeln abgek rzt werden die f r das AVAS System gelten Zu beachten ist dass maximal 64 Stellen eingegeben werden k nnen Des halb m ssen der Name der
404. gelegt GENERATE JOB LOG YES ERROR Bei der bertragung der Protokolldaten im Job trat ein Fehler auf Es werden keine Protokolldaten gespeichert IGNORE Im Jobablauf wurde ein Protokollname signalisiert Auf die Daten des Protokolls wurde nachtr glich verzichtet SAVED Das Die Protokoll e eines Jobs wurde n bei der JOBLOG Sicherung gespeichert TRANSFERRED Alle Protokolldaten wurden im Ablauf des Jobs fehlerfrei gesammelt U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb Status Priorit t Im DIRECTORY Eintrag der Elemente vom Typ S und bei der Anzeige der Gruppenzeile wird der Status nach folgender Priorit t bestimmt ERROR CREATED ASSIGNED ADDED TRANSFERRED SAVED IGNORE Einschr nkungen Die Satzl ngen der Protokolls tze d rfen die maximale L nge der jeweilig benutzten Soft ware nicht berschreiten Das hei t AVAS kann Protokolls tze mit einer maximalen L nge von 2028 Byte in der Protokollbibliothek sammeln Dagegen k nnen ber die SHOW Funk tionen mit dem EDT nur S tze mit einer L nge von 256 Byte angezeigt werden Bei l nge ren S tzen wird die laufende Funktion mit Fehler beendet 3 3 4 2 Sammeln der Protokolle Starten des CENTRAL Prozesses Neben den zentralen Zugriffsprozessen ZDs wird auf dem gleichen Rechner und der glei chen Kennung der CENTRAL Prozess gestartet der gegen ber der ZD ein einmaliger und eindeutiger Anwender ist Der CENTRAL P
405. gelesen Die Namen der neuen AVAS SYSTEM ID NEWSYSID der Ablaufdatei ABLDAT und der Journaldatei JRNDAT werden ber folgenden Vergleich gepr ft Eingabe EQ Wert aus System Parameterdatei Wenn eine Ungleichheit festgestellt wird wird der Auftragsschalter 11 gesetzt Der EDT wird beendet und nachfolgend der Auftragsschalter 11 abgefragt Ergebnis OFF Weiter in Prozedur ON Abbruch der Prozedur 7 Der Anwender wird aufgefordert den Namen der alten ersten Ablaufsteuerung OLDRCS 1 und den Namen der neuen ersten Ablaufsteuerung NEWRCS 1 vorzugeben 8 Die vorgegebene neue Ablaufdatei ABLDAT wird mit DPAGE er ffnet Der Datei steuerblock wird in die ber amp LISTE zugeordnete Datei ausgegeben Mit der vorge gebenen neuen Journaldatei JRNDAT wird entsprechend verfahren 9 Die ber amp LISTE zugeordnete Datei wird mit EDT eingelesen Ausgabe von DPAGE Der Name der alten AVAS SYSTEM ID OLDSYSID wird ber folgenden Vergleich ge pr ft Eingabe EQ Wert aus Ablaufdatei Wenn eine Ungleichheit festgestellt wird wird der Auftragsschalter 11 gesetzt 60 U21462 J Z125 7 Installation und Generierung Versionswechsel mit ABLDAT und JRNDAT Der Name der alten Ablaufsteuerung OLDRCS 1 wird ber folgenden Vergleich gepr ft Eingabe EQ Wert aus Ablaufdatei Wenn eine Ungleichheit festgestellt wird wird der Auftragsschalter 11 gesetzt Es wird gepr ft ob weitere Ablaufsteuerungen OLDRCS2
406. gemeldeten Return codes wie folgt Ein Fehlerfall wird an AVAS sofort zur ckgemeldet weitere RZ Routinen werden nicht aufgerufen Im Normalfall wird die n chste RZ Routine mit der Schnittstelle des RZ Exits auf gerufen Wenn an AVO3EXTV neben MARENAV weitere RZ Routinen angeschlossen werden sollen muss der Aufruf an MARENAV als letzter erfolgen damit dessen Returncode z B Ge nderte JCL Anweisung bernehmen an AVAS zur ck gemeldet wird Wenn der Benutzer in einer eigenen RZ Routine die von MARENAV ge nderten JCL Anweisungen lesen m chte muss AVO3EXTV so ge ndert werden dass der folgenden RZ Routine nicht die Schnittstelle des RZ Exits gegeben wird sondern die von MARENAV Bei der bersetzung muss als ALTLIB die Bibliothek SYSLIB AVAS 070 zugewie sen werden Zum Erstellen des EXIT Moduls mit MARENAV sind folgende Binderanweisungen in der angegebenen Reihenfolge anzugeben MODULE AVO3EXIT INCLUDE AVO3EXL Cavas systembibliothek INCLUDE AVO3EXT Cavas systembibliothek INCLUDE AVO3EXTV Cavas systembibliothek INCLUDE MARENAV Cavas systembibliothek USW Zum Erstellen des EXIT Moduls mit z B den RZ Routinen USERPROG und MARENAV sind folgende Binderanweisungen in der angegebenen Reihenfolge anzugeben MODULE AVO3EXIT INCLUDE AVO3EXL avas systembibliothek INCLUDE AVO3EXT Cavas systembibliothek INCLUDE AVO3EXTV Cavas systembibliothek INCLUDE AVEX7102 Cuser modulbibliothek
407. gen Benutzerangaben f r den Start eines Server Jobs werden aus der Konfigurationsdatei oder der Startprozedur f r AVSSINCM genommen 8 Anpassung der Startprozedur f r die Server berwachung In der ausgelieferten Startprozedur der Server berwachung sind folgende Startpara meter zu versorgen Name der Konfigurationsdatei Parameter CONFIG FILE NAME ggf ein Kennwort das zum Lesen der Konfigurationsdatei berechtigt Parameter CONFIG FILE PASSW Namen der Ablaufsteuerungen die mit der angegebenen Konfigurationsdatei arbei ten Parameter SERVER JV LINK 522 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung AVAS Schnittstelle f r externe Server 11 8 AVAS Schnittstelle f r externe Server AVAS bietet auch eine M glichkeit externe Server zum Abarbeiten von Jobs einzubinden In der Netzbeschreibung ist ein Strukturelement zum Start von Prozeduren zugelassen FUNCTION P mit TYPE EXX beschreibt ein Strukturelement zum Start einer externen Prozedur mit einer extern kontrollierenden Jobvariablen Die Jobvariable wird von der Ablaufsteuerung eingerichtet und beim Start der Prozedur nicht als Auftrags Jobvariable zugeordnet sondern als Prozedur Parameter mitgegeben Die Jobvariable muss durch den gestarteten Ablauf mit g ltigen Werten gem den Regeln f r die BS2000 Auftrags Jobvariable und f r die AVAS Anweisung AVJ versorgt werden Wenn der Name der Jobvariablen ggf mit Kennwort in einer Prozess
408. gramm beendet Wenn das Schreiben in die Ausgabedatei en nicht m glich ist wird die Bearbeitung der SELECT OBJECT Anweisung abgebrochen und das Programm beendet Wenn w hrend der Bearbeitung der AVAS Objekte auf ein durch AVAS gesperrtes Objekt zugegriffen wird wird eine Meldung ausgegeben und die Bearbeitung mit dem n chsten Objekt fortgesetzt Alle Fehler werden dem Benutzer mit einer Meldung und der entsprechenden Fehlerinfor mation mitgeteilt 256 U21462 J Z125 7 Dienstprogramm AVAS QUER Software Voraussetzungen 5 5 Software Voraussetzungen Software Abh ngigkeiten Folgende Produkte werden zum Ablauf von AVAS QUER ben tigt e BS2000 OSD ab V4 0 e SDF A ab V2 0A e File Transfer zum bertragen der Datei mit den SQL Anweisungen auf das Zielsystem Komponenten f r die Installation Folgende Komponenten werden f r AVAS QUER ausgeliefert Komponente Bedeutung SYSPRC AVAS 070 Bibliothek der Prozeduren Prozedur AVS QUER SYSPRG AVAS 070 SYSTEM Bibliothek der Systemphasen Programm AVAS SYS LOAD QUER SYSLNK AVAS 070 Bibliothek mit den Lademodulen SYSMES AVAS 070 Meldungsdatei im BS2000 0SD SYSSDF AVAS 070 Benutzersyntaxdatei Die Dateien m ssen auf die gew nschte Benutzerkennung kopiert werden Syntaxdatei installieren Die SDF Syntaxdatei SYSSDF AVAS 070 die die Anweisungen f r AVAS QUER enth lt muss aktiv sein Sie kann entweder mit dem Dienstprogramm SDF I in die aktuelle System syntaxdatei
409. hat z B dann nicht wenn das Ergebnis des fehlerhaften Netzes nicht mehr in die Ergebnistabelle ge schrieben werden konnte Es ist demnach sicherer die Ausgabe in die SAM Datei zu veranlassen wenn die Anzahl der bearbeiteten Elemente nicht kalkuliert werden kann U21462 J Z125 7 AVSOFILE AVSONECT Aufbau der Verst ndigungsbereiche 382 Programmschnittstelle von AVAS Aufbau der Verst ndigungsbereiche AVSOTAB Anfang der Ergebnistabelle Von hier ab muss wenigstens so viel Platz zur Verf gung stehen wie es dem Produkt aus dem Wert in AVSONECT und der L nge eines Ergebnis ses entspricht Die folgenden Makros bzw COPY Elemente zur Beschrei bung eines Tabelleneintrags m ssen an dieser Stelle aufgerufen werden Die Anweisungen erzeugen pro Element folgende Ergebnisse SIGNON und END Diese Anweisungen erzeugen in diesem Bereich kein Ergebnis CREATE PLAN NET CREATE PROD NET MODIFY COND DESCRIPTION SUBMIT NET und RESTART NET Das Ergebnis dieser Anweisungen wird mit dem Makro AVSASSRT bzw dem COPY Element AVSCOBRT beschrieben AVSECDNM Name des Bedingungseintrags AVSEEASD Parameter EARLIEST START NEW PLAN START Datum AVSEEAST Parameter EARLIEST START NEW PLAN START Uhrzeit AVSENAME Name des Elements AVSENETN Name des Netzes AVSERLTC Code des RESULT Textes positives Ergebnis siehe auch Feld AVSRRLTC im Kommunikationsbereich AVSERLTT RESULT Text AVSERSVT Restart Variante AVSESYND Parameter SYMDAT N
410. hgef hrt e Nur Werte f r die Parameterfelder P nnn d rfen bergeben werden e Wenn eine Maske wegen des Returncodes X 02 nicht ausgegeben wird werden die von der RZ Routine bergebenen Parameter mit den auf der Maske definierten Feldern nicht abgeglichen Alle von der RZ Routine bergebenen Felder mit einem g ltigen Parameterschl ssel P nnn werden f r die Modifikation verwendet Dies gilt wenn die RZ Routine im Dialog oder ber die AVAS BATCH Funktion aufge rufen wird Beim AVAS BATCH kann die RZ Routine nur verwendet werden wenn sie den Returncode X 02 zur ckmeldet U21462 J Z125 7 95 Installation und Generierung 2 4 15 RZ Exit AVEX6802 RZ Exits im AVAS System Bevor die Werte der Variablen P nnn modifiziert werden ruft AVAS die RZ Routine auf Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie Ausgabe Parameter Netzname Ausgabe Parameter Job Index Ausgabe Parameter Jobname Ausgabe Parameter Name der Jobmaske Eingabe Parameter Fehlermeldung nur bei RETURNCODE pfixNO Ausgabe Parameter EQUATE f r L nge des Basisdatenteils folgt pfixNNAM pfixJIND pfixJNAM pfixFNAM pfixFMSG pfixDFIX bergabe von AVAS an die RZ Routine Anschlie end an den Basisdatenteil werden die Werte Daten der Maskenfelder in folgen der Form im Kommunikationsbereich bergeben 2 Byte 2 Byte 8 Byte 2 Byte maximale L nge 192 Byte 2 Byte n Byte maximal
411. hier nicht verf gbar ist period Symbolischer Name einer Periode U21462 J Z125 7 378 Programmschnittstelle von AVAS READ AVAS LIBRARY tt mm jj hh mm ss tt mm jj hh mm ss Reale Datums und Zeitangaben die Anfangs und Enddatum Zeit bestimmen Wenn Enddatum Zeit nicht angegeben werden wird das Enddatum auf Anfangsdatum gesetzt und die Endzeit auf 23 59 59 Wenn die Anfangszeit nicht angegeben wird wird 00 00 00 ange nommen RUN CONTROL SYSTEM avak Name der Ablaufsteuerung Wenn der Parameter nicht angegeben wurde wird die dem Benut zer zugeordnete Ablaufsteuerung angenommen Die Ausgabe der gew nschten Informationen erfolgt in den Ergebnisbereich OUTAREA siehe Abschnitt Aufbau der Verst ndigungsbereiche auf Seite 380 oder in die dem Bereich zugeordnete SAM Datei Die Struktur der Information wird in folgenden Assembler Makros bzw Cobol COPY Elementen beschrieben Cobol AVSCOBJD Verzeichniseintrag der Journaldatei AVSCOBJN Journalsatzkopf 1 schl sselspezifischer Teil der Journals tze siehe Abschnitt Daten strukturen der Journalsicherung und der Not Journaldatei auf Seite 187 AVSCOBAD Netzverzeichniseintrag der Ablaufdatei AVSCOBAN Netzstrukturdaten in der Ablaufdatei AVSCOBCD Verzeichniseintrag f r Bedingungseintr ge AVSCOBCE Bedingungseintrag in der Ablaufdatei ASS AVSASSJD AVSASSJN AVASJRN AVSASSAD AVSASSAN AVSASSCD AVSASSCE 1 F r diese Daten i
412. hlt wird k nnen eventuell in einigen Feldern nicht alle Zeichen dargestellt werden Zum einfacheren Starten von AVAS DOORS empfiehlt es sich eine AVAS DOORS Ikone zu erzeugen Erzeugen einer AVAS DOORS Ikone Sie k nnen zu einer AVAS DOORS Sitzung eine eigene Ikone im Programm Manager von Microsoft Windows erzeugen um diese Sitzung dann nur durch Doppelklick auf die Ikone direkt zu starten Um eine solche AVAS DOORS Ikone zu erzeugen gehen Sie folgender ma en vor 1 Erzeugen einer Parameterdatei f r die Terminal Emulation optional Erzeugen Sie eine Parameterdatei f r die Verbindungs Parameter der Terminal Emula tion die Sie verwenden m chten Die weiteren Schritte sind abh ngig von der verwen deten Terminal Emulation und werden hier nicht n her ausgef hrt Lesen Sie dazu bitte die Beschreibung der verwendeten Terminal Emulation Die Beschreibung der DOORS Mini Emulation finden Sie im Handbuch FHS DOORS Grafische Oberfl che f r BS2000 Anwendungen 8 Wenn noch kein Verbindungsname f r die Verbindung zur AVAS Anwendung eingerich tet ist m ssen Sie gegebenenfalls erst einen neuen Verbindungsnamen einrichten n heres hierzu finden Sie in der Beschreibung der verwendeten Emulation Zum automatischen Starten von AVAS k nnen Sie ein Startup Script schreiben Wenn Sie z B AVAS starten wollen unter der Kennung AVASD mit der Abrechnungsnummer 123 und mit der LOGON Prozedur START AVAS geben Sie fo
413. hnittstelle X OB CREATED X 14 ABENDED X 15 ENDED X 16 ERROR X 17 HOLD X 18 RUNNING X 19 WAITING X 3E SKIPPED X 42 EXECUTED X 9B OCCURRED X 9C NO OCCURE X AD HOSTWAIT NST2 X Geforderte Aktion einer Dialogfunktion auch BATCH und Programm schnittstelle Die Aktion wird von der Ablaufsteuerung umgesetzt wenn das Strukturelement zur Verarbeitung kommt X 00 LOW Es ist keine Aktion gefordert X 17 HOLD X 1C RESUMED NST3 X Status von Strukturelementen die nicht zur Verarbeitung kommen X 00 LOW Der Status ist nicht gesetzt X 3F IGNORED X 7C NO PLAN X 7D DELETED X 85 NO SUBMIT NSTTS X Sicherung des aktuellen Verarbeitungsstatus NSTT wenn die Netzverarbei tung unterbrochen ist NSTT HOLD oder NSTT RESUMED X 00 LOW Es ist kein Status gesichert X 16 ERROR X 19 WAITING X 9C NO OCCURE X AD HOSTWAIT Beispiel INDEX NSTT NST2 NST3 NSTTS 010 X 9B X 00 X 00 X 00 OCCURRED FU C W 020 X 15 X 00 X 00 X 00 ENDED FU P 020 X 42 X 00 X 00 X 00 EXECUTED FU A M DD 030 X 15 X 00 X 7C X 00 NO PLA bearbeitet 040 X 17 X 00 X 00 X 19 HOLD auf WAITING 050 X 19 X 00 X 85 X 00 NO SUBMIT nicht bearbeitet 060 X 19 X 17 X 7D X 00 DELETED HOLD gefordert noch nicht bearbeitet U21462 J Z125 7 398 Programmschnittstelle von AVAS Assembler Schnittstelle Der Index 010 020 und 030 wurde von der Ablaufsteuerung verarbeitet Das Strukturelement au
414. iante aller Netze KEY 01 e Ein komprimierter Satz f r jeden Job unterhalb eines Netzes KEY 02 e Einen Satz f r jedes abgelaufene Netz KEY 03 e Einen Satz f r jeden Job der unterhalb eines Netzes zum Ablauf gebracht wurde KEY 04 Die Auswertefunktion HISTORY kann f r Netze Jobs in Netzen und Jobs verwendet werden Es werden Datens tze mit folgenden Schl sseln und Komprimierungsstufen gespeichert KEY bk net n YYYYMMTT hhmmss SYMD Index bk job n FU TYP 01 X X X N SUM 02 X X x x x J B X SUM 03 X X X X X N NET 04 X X X X x x x J B X JOB X Wert vorhanden Kein Wert vorhanden Leerzeichen Das Speichern der Daten erfolgt in einer ISAM Datei mit den Schl sselfeldern KEY USER GROUP NET NAME PLAN START DATE PLAN START TIME SYMDAT NAME INDEX JOB NAME FU und TYP Das Aktualisieren der Datei erfolgt bei der Reorganisation der Journaldatei Funktion JOUR mit dem Parameter HISTORY SAVE OPTION Die Auswertung erfolgt durch die Operation SHOW HISTORY bei der Anweisung NET CONTROL Das L schen von Datens tzen erfolgt bei der Reorganisation mit der Funktion HISTORY Zum L schen von Datens tzen in der HISTORY Datei werden bei der Funktion HISTORY neben NET NAME die Parameter HISTORY DELETE OPTION HISTORY DELETE DATE und HISTORY KEEP RECORDS zugelassen In den komprimierten S tzen KEY 01 02 werden maximal 64 Laufzeiten und Wartezeiten
415. icht dem Feld in der Zeile 23 der AVAS Masken pfixNNAM Ausgabe Parameter Name des markierten Netzes pfixJIND Ausgabe Parameter Struktur Index pfixFUNC Ausgabe Parameter FUNCTION Typ pfixFNAM Ausgabe Parameter FUNCTION Name pfixCNAM Ausgabe Parameter CONDITION NET Name pfixSNAM Ausgabe Parameter SUBNET Name pfixJNAM Ausgabe Parameter Job Name pfixCMDA Ausgabe Parameter CMD Adresse U21462 J Z125 7 2 4 11 90 Installation und Generierung RZ Exits im AVAS System Hinweise Die Parameter ab pfixNNAM werden nur dann versorgt wenn der EXIT mit dem Operationscode 55 aus NET CONTROL aufgerufen wird und dabei Netz e oder Strukturelement e markiert sind Beim Aufruf aus der Maske AVIO22 LIST OF NETS werden nur die Felder pfixNNAM und pfixCMDA versorgt F r die anderen Felder sind sinnvolle Werte nicht definiert Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS keinen Returncode zur ckmelden Das Feld pfixRSC wird nicht ausgewertet Im Feld pfixMSG kann an AVAS eine Meldung bergeben werden Wenn eine Meldung bergeben wird wird sie in Maske AVS030 mit dem Meldungsschl ssel AVS5225 ausge geben 2 4 12 RZ Exit AVEX6601 Bevor eine zugeordnete Benutzermaske zur Bearbeitung ausgegeben wird ruft AVAS die RZ Routine auf Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie folgt pfixNNAM Ausgabe Parameter Netzname pfixFNAM Ausgabe Parameter Name
416. ie AVAS Versionen im BS2000 OSD betroffene Komponente ist der AVAS Agent avssincm werden den Server Versionen avsrecv gegen bergestellt Die folgende Tabelle beinhaltet eine Aufstellung der Versionen Unter Bemerkungen ist beschrieben was beim Zusammenspiel zu beachten ist AVAS Agent AVAS Server AVAS R3JobControl Bemerkungen avssincm avsrecv siehe Punkt Windows UNIX Systeme V5 0A V4 1C10 V1 0B 1 V4 1C20 2 V6 0A V6 0A00 V1 0C 3 V7 0A V4 1C10 C20 V1 0D 4 V6 0A00 5 V7 0A00 6 Bemerkungen zu 1 AVAS Server V4 1C10 Mit AVAS V5 0 wird eine CD ausgeliefert einschlie lich AVAS DOORS V5 0 und AVAS SV 4 10 Diese enth lt gegen ber V4 1A folgende neue Bestandteile f r Windows Systeme ein Programm zum Aktualisieren der AVAS Einstellungen in der Registry eine Schnittstelle f r einen Programmstart aus Server Jobs heraus Korrekturen 14 U21462 J Z125 7 Installation und Generierung Installation des AVAS Systems 2 AVAS SV V4 1C20 Der Server AVAS SV V4 1C20 enth lt folgende neue Funktionen gegen ber V4 1C10 Unterst tzung weiterer Betriebssysteme SuSE LINUX 7 0 auf Intel Plattform True64 UNIX und Windows Systeme Anschluss an die Benutzerverwaltung von Windows Systemen dadurch wird es m glich innerhalb einer Dom ne Jobs unter einer bestimmten Kennung ablaufen Zu lassen Korrekturen 3 AVAS SV V6 0A Mit AVAS V6 0A w
417. ie Prozedur mit sh install avs Wenn die Installation unter der root Kennung aufgerufen wird wird nach einer Benutzerken nung f r den AVAS Betrieb gefragt und AVAS SV nach HOME AVAS SV installiert Wenn die eingegebene Kennung root ist erfolgt die Installation nach opt AVAS SV und AVAS Jobs k nnen unter jeder Kennung ablaufen Der Programmpfad f r die Dienst programme avslog und avssinjv ist in diesem Fall opt AVAS SV bin Die Installation wird mit einer Fehlermeldung abgebrochen wenn die eingegebene Kennung im System unbekannt oder das Home Verzeichnis nicht angelegt ist Die Prozedur install avs kann auch unter einem beliebigen Benutzerlogin aufgerufen werden In diesem Fall wird AVAS SV im Verzeichnis HOME AVAS SV der Kennung instal liert Der Programmpfad f r die Dienstprogramme avslog und avssinjv ist HOME AVAS SV bin Die zu berwachenden AVAS Jobs m ssen unter dieser Kennung ab lauff hig sein U21462 J Z125 7 445 Installation von AVAS SV AVAS SV Plattform bergreifende Jobsteuerung Anschlie end werden Sie wie in Windows Systemen nach den Startparametern des AVAS Servers gefragt Auch hier werden Standardwerte eingestellt f r Portnummer Kommunikationskennwort Protokolldatei Verzeichnisname f r tempor re Server Dateien Diese Werte werden mit der ENTER Taste bernommen oder durch eine neue Eingabe ge ndert Die Eingabewerte werden im Installationsverzeichnis von AVAS SV in der Da
418. ie dient dem Arbeitsvorbereiter dazu alle w hrend des Ablaufs eines Netzes ben tigten Datentr ger bereitzustellen Wenn ein Datentr ger in einem Netz mehrfach verwendet wird wird er dennoch nur einmal in der Transportliste aufgef hrt Der Listenkopf dieser Datei enth lt folgende Angaben e Dateiname der Datentr gerliste e Datum und Uhrzeit der Produktionsfreigabe e Name des Netzes e geplanter Ablauftermin e Anzahl aller Anforderungen f r SCRATCH B nder eines bestimmten Ger tetyps e Anzahl aller angeforderten PRIVATE B nder eines bestimmten Ger tetyps Wenn bei der Netzfreigabe eine Lagerortdatei zugewiesen wurde mit LINKZMARENAVL werden die SCRATCH und PRIVATE Bandanforderungen auch noch getrennt nach Lager orten ausgegeben Im Anschluss an den Listenkopf folgt f r jede in diesem Netz angesprochene VSN eine Zei le mit folgendem Aufbau e Hierarchiestufe Index des Jobs der diese VSN anfordert e Jobname aus dem Kommando SET LOGON PARAMETERS e Katalogkennung des Rechners an dem der Datentr ger verarbeitet wird e Aktueller Lagerort des Datentr gers FROM LOC e Der Katalogkennung zugeordneter Lagerort TO LOC An diesem wird der Daten tr ger beim Ablauf des Netzes angefordert Wenn bei der Netzfreigabe keine Lagerort datei zugewiesen wurde bleibt diese Spalte leer e VSN Archivnummer des Datentr gers e Eventuell Hinweis auf eine eingeschr nkte Verf gbarkeit des Datentr gers z B Band ist ausgeli
419. ie zu ndernden Parameter und zugelassenen Werte sind bei der Dialogfunktion be schrieben CHANGE NET DESCRIPTION NET NAME bk netname RETENTION PERIOD wert OLD USER wert NEW USER wert OLD PASSWORD wert NEW PASSWORD wert OLD ACCOUNT wert NEW ACCOUNT wert OLD CLASS wert NEW CLASS wert OLD LOG wert NEW LOG wert OLD CAT wert NEW CAT wert Der Parameter NET NAME muss angegeben werden der Parameterwert kann teilqualifi ziert angegeben werden Die folgenden Parameter die ge ndert werden sollen m ssen als Parameter paarweise OLD und NEW angegeben werden Die Schl sselw rter DEL und INS f r nicht vorhandene Werte m ssen angegeben wer den zB OLD ACCOUNT INS NEW ACCOUNT AVAS20A Soll einer der Parameter USER und oder PASSWORD ge ndert werden m ssen in jedem Fall beide Parameter mit den alten und den neuen Werten angegeben werden Die Parameter OLD para und NEW para entsprechen den Parameterfeldern der Maske AVN007 U21462 J Z125 7 316 BATCH Anweisungen CHANGE NET DESCRIPTION Hinweis Die BATCH Verarbeitung wird mit einer Fehlermeldung abgebrochen wenn fehlerhafte Parameter erkannt werden Die Meldung AVS5051 AVS5052 AVS5054 oder AVS5240 wird ausgegeben Protokoll der Verarbeitung F r jedes ge nderte Netz wird AVS8521 CHANGE NET DESCRIPTION netname RESULT ergebnis ausgegeben oder eine Fehlermeldung U21462 J Z125 7 317 COPY ELEMENT BATCH Anweisung
420. ieben U21462 J Z125 7 414 Programmschnittstelle von AVAS Assembler Schnittstelle Aufl sung des Makros AVSASSJN AVSASSJN MFCHK MF C PREFIX A MACID VSP DMACID VSP SUPPORT C D DS OF PREFIX A MACID VSP JA JRNDAT NET JOURNAL DESCRIPTION AVSPJNET DS 0CL384 AVSPULEN DS H USED LENGTH DS H RESERVED AVSPDATE DS CL6 OUTPUT DATE AVSPTIME DS 06 OUTPUT TIME AVSPNUMS DS XL2 NUMBER AFTER TIME AVSPACMD DS X AVAS COMMAND AVSPAKTN DS X EXECUTED ACTION AVSPUSER DS CL8 AVAS USER AVSPINDX DS INDEX AVSPFUNC DS C FUNCTIO AVSPNAME DS CL32 NAME OF ELEMENT AVSPRECA DS 001320 RECORD AREA WITH KEY MAX L 320 AVSPRSSL DS CL2 RECORD KEY AVSPRFNR DS CL2 RECORD FUNCTION KEY AVSPOUTD DS 01316 OUTPUT DATA MAX L 316 FOR OUTPUT DATA DSECT USE MACRO AVASJRN ORG amp P OUTD SSL AVASJRN amp PRE Hr x o 0X DS 0C U21462 J Z125 7 415 Programmschnittstelle von AVAS Assembler Schnittstelle AVSASSRT Resultatbereich definieren Parameter MF C D PREFIX A char 1 gt MACID VSE char 3 lt AVSASSRT Makro Parameter MF und PREFIX siehe AVSASSAD auf Seite 389 Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Standardwert VSE M
421. ieht z B folgenderma en aus DEST G31HELIOS TYPE A ASHOST helios SYSNR 00 RFC_TRACE 0O Der Parameter DEST Destination ist der Schl ssel f r alle weiteren Eintr ge in der Datei bis zur n chsten Destination Der Parameter TYPE definiert den Verbindungstyp der RFC Verbindung F r avasr3 als RFC Client Programm stehen f r den Verbindungstyp der Wert A f r die Anmeldung an einem bestimmten Applikationsserver zur Verf gung und der Wert B bei Verwendung von Load Balancing U21462 J Z125 7 11 5 4 11 5 4 1 11 5 4 2 496 AVAS SV Plattform bergreifende Jobsteuerung Steuerung von SAP R 3 Jobs mit AVAS Im obigen Beispiel bezeichnen die Parameter ASHOST den Host Namen des mySAP com Applikationsservers und SYSNR die mySAP com Systemnummer bzw den TCP IP Service des mySAP com Systems Der Host Name helios muss in der Datei hosts und der Service Name des speziellen Applikationsservers muss in der Datei services defi niert sein sapdpOO f r den Dispatcher Service und sapgw00 f r den Gateway Service Der Parameter RFC TRACE dient zum Schreiben von RFC Trace Dateien bei RFC TRACE O0 wird kein Trace geschrieben Standard bei 1 wird eine Trace Datei geschrieben F r weiterf hrende Informationen wird auf die mySAP com Dokumentation verwiesen Die mySAP com Benutzerdaten die f r die Anmeldung am mySAP com ben tigt werden werden in der Datei sapuser ini abgelegt Beispiel f r eine sapuser ini Datei USER AVAS
422. iese f r das Lesen verwendet Andernfalls wird der Dateiname mit der Katalogkennung erg nzt die von AVAS am RZ Exit AVEX7102 bergeben wurde Beispiel Am RZ Exit wird an MARENAV die Katalogkennung 2 bergeben In einem Job des Netzes befindet sich ein Kommando SET FILE LINK LINK LINKOl FILE NAME BKOl DATEII Der Katalogeintrag wird wie folgt gelesen SHOW FILE ATTRIBUTES 2 BKO1 DATEIl U21462 J Z125 7 261 Durchf hren von Datentr gerpr fungen Kopplung AVAS mit MAREN In diesem Zusammenhang ist zu ber cksichtigen dass diese Erg nzung des Dateinamens dann fehlerhaft sein kann wenn am Zielrechner ein MPVS System eingerichtet ist Am Zielrechner kann f r die Kennung BKO1 eine andere CATID eingetragen sein als sie von AVAS am RZ Exit bergeben wird Bei der Netzfreigabe wird folglich der Katalogeintrag einer anderen Datei gelesen als der der beim Ablauf des Netzes tats chlich angesprochen wird Ein Netz wird in der Regel nicht unter der Systemverwalterkennung TSOS freigegeben Daher ist es nicht m glich die Standard CATID des Zielrechners durch Lesen der Benut zereintr ge zu ermitteln Ein korrekter Erg nzungsalgorithmus f r die Dateinamen ist des halb nicht immer gew hrleistet Wenn das DVS beim Lesen des Katalogeintrags einen der folgenden Fehler meldet wird die Netzfreigabe mit der Meldung CATALOG amp 00 NOT ACCESSIBLE abgebrochen DMS0501 REQUESTED CATALOG NOT ACCESSIBLE COMMAND REJECTED D
423. ieser Parameter auf X 00000000 gesetzt AVS JOB ID Interne AVAS Jobkennung AVS JOB INDEX Job Index aus der Netzbeschreibung AVS JOB NAME Job Name aus der Netzbeschreibung AVS JOB TYPE Gibt an ob das Job Skript in AVAS verwaltet wird oder im Server System vorliegt AVS MONJV PASSW Kennwort f r die Monitor Jobvariable in sedezimaler Form Wenn kein Kennwort verwendet wird enth lt der Parameter den Wert NONE Wenn weniger als 8 Zeichen bergeben werden erg nzt AVSSINCM die bergabe mit f hrenden Nullen AVS NET NAME Netz Name aus der Netzbeschreibung U21462 J Z125 7 465 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung AVS SERVER NAME Servername aus der Netzbeschreibung AVS SERVER PASSW Kennwort mit dem der Benutzer nachweist dass er den angegebe nen AVS SERVER NAME benutzen darf aus Maske AVNOO9 AVS SERVER PARAM String der Skript und Parameter in der Datei AVS AVAK FILE trennt AVS SERVER VERSION Version des AVAS Servers AVSRECV AVS SYSTEM ID Kennung des AVAS Systems AVS AVAS VERSION AVAS Version AVS AVAK FILE PASSW Kennwort eines externen Jobs oder NONE AVS JOB CLASS Bei einem BS2000 Server Job Name der Jobklasse aus der Netzbeschreibung sonst NONE AVS JOB LOG Bei einem BS2000 Server Job Wert f r LOGGING Parameter YES NO aus der Netzbeschrei bung Parameter LOG sonst NONE AVS JOB PARAMETER Bei einem BS2000 Server Job Wert f r Job Paramet
424. ig abdruckbar von 999 bis 9999 in die Jobvariable einge tragen Zus tzlich wird beim Jobende der AVAS Bereich der Jobvariablen der ber das Dienstprogramm AVSSINJV siehe Seite 492 vom Server Job modifiziert werden kann bernommen 472 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs e Nach jedem der oben beschriebenen Arbeitsschritte wird die JV Datei aktualisiert und an AVSSINCM gesendet e Wenn im Job mit dem Programm avslog signalisiert wurde dass LOG Dateien zum BS2000 OSD bertragen werden sollen bergibt AVSSTRT diese an AVSSINCM e Wenn die END Nachricht fehlerfreie R ckmeldung des Ergebnisses von AVSSINCM eingetroffen ist werden die von AVSSTHT eingerichteten Dateien f r das Server Skript und die Jobvariable gel scht AVSSTRT l scht die zum BS2000 OSD bertragenen LOG Dateien wenn dies beim Aufruf von avslog mitgeteilt wurde Danach beendet sich AVSSTRT e Wenn vor dem Eintreffen der END Nachricht die Verbindung ausf llt wird in der JV Datei der SV Status auf E gesetzt und der Zusatzstatus unver ndert gelassen Die JV Datei und die Skriptdatei werden in diesem Fall im Server System nicht gel scht damit der Status des Server Jobs nach der Wiederherstellung der Verbindung und einem Restart f r den Job ermittelt werden kann Wenn f r einen Job der wegen Verbindungsverlust den Status ERROR erhalten hat ein Restart eingeleitet wird bei
425. in Klammern bk Benutzerkreis 1 4 netzname Netzname 1 12 plandatum geplantes Startdatum 6 planzeit geplante Startzeit 6 catid Katalogkennung 1 4 tsn Tasknummer 4 datum Datum des Protokolleintrags 8 nn lfd Protokollnummer 2 Elementaufbau Typ S e Inhaltsverzeichnis Satz Im Inhaltsverzeichnis Satz werden AVAS Informationen abgelegt die f r die Bearbei tung der Protokolle eines Jobs erforderlich sind Aufbau SYSLOG lt s1 gt lt s2 gt lt s3 gt lt s4 gt Bedeutung und L nge der Namensteile in Klammern SYSLOG Satzidentifikation 8 51 Name der Ablaufsteuerung 8 52 Indexstufe des Strukturelements im Netz 3 s3 Name des Strukturelements im Netz 24 ohne Benutzerkreis s4 AVAS interner Bereich 138 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb e Protokollmeldungs Satz maximal 99 pro Job F r jedes signalisierte Protokoll wird ein Satz mit der Identifikation JOBLOG einge tragen Der Satz mit diesem eindeutigen Merkmal beschreibt in den weiteren Stellen notwendige Informationen zu einem Protokoll Aufbau JOBLOG lt j1 gt lt j5 gt lt j6 gt lt j7 gt lt j8 gt lt j9 gt lt j2 gt lt 2t gt lt j3 gt lt 3t gt lt j4 gt lt 4t gt Bedeutung und Lange der Namensteile in Klammern JOBLOG Satzidentifikation 8 j1 Protokoll Nummer 2 j5 AVAS Returncode 4 j6 SUBSYSTEM Returncode 7 j7 JOBLOG Name 54 j8 Datum jjjjmmtt 8
426. in dem genannten Handbuch dann die entsprechende Stelle im Text finden Erg nzende Informationen sind durch Hinweis gekennzeichnet In diesem Handbuch werden folgende Darstellungsmittel verwendet Dieses Symbol steht mit dem Signalwort ACHTUNG vor Warnhin weisen die Sie unbedingt beachten m ssen um Datenverlust oder eine Besch digung des Systems zu vermeiden Maschinenschrift Pfad Verzeichnisnamen sowie Ablauf und Prozedurbeispiele sind in Schreibmaschinenschrift wiedergegeben kursiv Namen von Dateien Programmen Dialogfeldern und Men be zeichnungen bei UNIX und Windows Systemen Halbfette Maschinenschrift Eingaben durch den Benutzer am Bildschirm U21462 J Z125 7 11 Verwendete Metasprache Einleitung 12 U21462 J Z125 7 2 Installation und Generierung In diesem Kapitel sind die Installation und Generierung des AVAS Systems beschrieben 2 1 Installation des AVAS Systems AVAS wird mit dem Installationsmonitor IMON installiert F r die Installation des Produkts m ssen zus tzlich die Installationshinweise in der Frei gabemitteilung ber cksichtigt werden 2 1 1 AVAS SV Die AVAS Server f r UNIX und Windows Systeme werden von einer CD installiert die nach ISO9660 strukturiert ist Die CD beinhaltet Installations und Produktsoftware f r AVAS SV und AVAS DOORS Sie enth lt auch die Zusatzfunktion zum Steuern von Jobs in Systemen mit mySAP com Das Programm AVAS R3JobControl AVA
427. in der Maske AVNOO2 DEFAULT RESTART TYPE RESTART NORMAL RESTART AUTO NORMAL AUTO Standardwert f r den Parameter RESTART TYPE DEFAULT RESTART JOB ALL NAME ERROR Standardwert f r den Parameter RESTART JOB NAME DEFAULT CONDITION TYPE NET JVA Standardwert f r den Parameter COND TYPE DEFAULT CONDITION DELAY START CANCEL IGNORE Standardwert f r den Parameter DELAY SOLUTION in den Netzstrukturbeschreibun gen bei FUNCTION C DEFAULT JOB DELAY START CANCEL IGNORE Standardwert f r den Parameter DELAY SOLUTION in den Netzstrukturbeschreibun gen bei FUNCTION J P X DEFAULT JVA POSITION 001 256 Standardwert f r den Parameter JVA POSITION DEFAULT JVA LENGTH 001 256 Standardwert f r den Parameter JVA LENGTH Definition von Standardwerten f r die Netzplanung DEFAULT LIFE TIME ttt hh mm NONE Pflichtparameter Standardwert f r den Parameter LIFE TIME in den Masken AVPO01 und AVPO003 Bei der Produktionsplanung ersetzt der angegebene Wert den Wert STD Beim Reorganisieren der Ablaufdatei werden Bedingungseintr ge f r Netze die fehler frei zu Ende gelaufen sind und deren LIFE TIME abgelaufen ist gel scht DEFAULT LATEST NETSTART ttt hh mm Pflichtparameter Standardwert f r den Parameter LATEST START in der Netzbeschreibung Bei der Netzplanung ersetzt der angegebene Wert den Wert NONE bei der Beschrei bung der Startparameter f r das Netz DEFAULT LATEST JOBSTARTSttt hh
428. in der Produktionsdurchf hrung durch die Ablaufsteue rung gem den Terminvorgaben und Abh ngigkeiten gestartet Die Produktionskontrolle erfolgt wie alle vorherigen Schritte online Im Fehlerfall kommt die vorgeplante Restart Verarbeitung zum Tragen Je nach Vorgabe im Netz l uft der Restart entweder automatisch an oder der Benutzer leitet ihn spezifisch ein wobei auch noch ma nuelle Eingriffe vorgenommen werden k nnen S mtliche Arbeiten an Netzen die f r die Produktion vorgesehen wurden werden protokolliert Sie k nnen anhand des Journals nachvollzogen werden Die Ablaufprotokolle der Jobs k nnen unter AVAS gespeichert und angezeigt werden 1 2 Zielgruppen des Handbuchs Dieses Handbuch wendet sich an den AVAS Administrator 2 U21462 J Z125 7 Einleitung Verf gbare Dokumentation zu AVAS V7 0A 1 3 Verf gbare Dokumentation zu AVAS V7 0A F r das Arbeiten mit dem Softwareprodukt AVAS V7 0A im Betriebssystem BS2000 OSD steht Ihnen folgende Dokumentation zur Verf gung e AVAS Anweisungen Benutzerhandbuch Bestellnr U24660 J Z125 5 e AVAS f r den Administrator Systemverwalterhandbuch Bestellnr U21462 J Z125 7 e AVAS Funktionen Benutzerhandbuch Bestellnr U5184 J Z125 10 e AVAS Tabellenheft Tabellenheft Bestellnr U5309 J Z125 10 F r das Arbeiten mit AVAS DOORS V7 0A kann zus tzlich folgende Dokumentation hilf reich sein e FHS DOORS V3 1 Windows Grafische Oberfl che f r B852000 OSD Anweis
429. iniert den Netzbeschreibungssatz 5 mit den Masken f r netzweite Modi fikations Parameter MACID RECORD lt char 3 gt RECORD N1 N2 N3 N4 N5 J1 C1 A1 M1 D1 W1 S1 Definiert den Satz 1 einer Strukturelementbeschreibung mit den symboli schen Startterminen SYMDAT und den zugeordneten Planungs Parame tern J2 C2 A2 M2 D2 W2 S2 Definiert den Satz 2 einer Strukturelementbeschreibung mit den Restart Punkten und mit dem ersten Teil der Parameter des Strukturelements J3 C3 A3 M3 D3 W3 S3 Definiert den Satz 3 einer Strukturelementbeschreibung mit dem zweiten Teil der Parameter des Strukturelements Hinweis Der Makro AVASNET ruft intern den Makro MFCHK auf Bei einer Assemblierung ist daher neben der AVAS Makrobibliothek auch die BS2000 Makrobibliothek zuzuweisen oder AVASNET ist in die BS2000 Makrobibliothek einzumischen 349 U21462 J Z125 7 Externe programmtechnische Erstellung von Netzen Externe Erstellung von AVAS Elementen Aufl sungen des Makros AVASNET AVASNET RECORDzNI MFCHK MF C 0 PREFIX N 0 MACID NI C DMACID NID C SUPPORT C D DS OF ZA PREFIX N MACID N1 HHHHE NN1A DS OF NNISLEN DS H PLAM RECORD LENGTH DS C PLAM RESERVED PLAM SK DS C PLAM RESERVED PLAM SA NNISSL DS CL2 RECORD KEY DS CL1 RESERVED DS CL RESERVED DS CL RESERVED NNIIND DS CL3 ET INDEX 000 NNINAM DS CL18 ET NAME DS CL14 RESE
430. inige neue Funktionen wurden bestehende Journals tze erweitert siehe unten Kompatibilit t Exit Routinen zur Auswertung von Journals tzen Exits 1 und AVEX0002 m ssen deshalb u U angepasst werden BATCH Anweisungen Alle Batchabl ufe der Version 6 0A k nnen unver ndert in die Version 7 0A bernom men werden Kompatibilit t Folgende Journal S tze wurden erweitert 11 00 07 CAL NAME 31 00 07 NET CAT 32 00 JOB CAT 53 01 02 JVA Vergleichslogik 54 01 02 04 COND VALUE 55 00 NET CAT 56 01 02 JOB CAT U21462 J Z125 7 Einleitung Verwendete Metasprache Folgende Listen die mit der PRINT Operation ausgegeben werden wurden erweitert AVLO01 CALENDAR NAME AVLOO5 COND VALUE JVA Vergleichslogik AVLO13 CALENDAR NAME PLAN START SYMDAT AVLO14 CALENDAR NAME AVLO21 NET CAT AVLO22 JOB CAT AVLO23 COND VALUE JVA Vergleichslogik 1 8 Verwendete Metasprache Literaturhinweise sind im Text durch Kurztitel angegeben die in Anf hrungszeichen stehen Die vollst ndigen Titel auf die durch eine Nummer verwiesen wird sind im Literaturver zeichnis hinter der entsprechenden Nummer zusammen mit einer Kurzbeschreibung auf gef hrt Verweise innerhalb dieses Handbuchs geben die betreffende Seite im Handbuch an und je nach Bedarf auch den Abschnitt oder das Kapitel Verweise auf Themen die in einem anderen Handbuch beschrieben sind enthalten nur den Kurztitel dieses Handbuchs ber das Stichwortverzeichnis k nnen Sie
431. inn der Parameter anweisung 13 42 Anweisung die mit einer Berechtigung versehen werden soll 43 43 Trennzeichen zwischen Beschreibungen eines Parameters b 44 44 Berechtigungsschl ssel f r die Anweisung 45 45 Klammer zu Ende der Parameter Beim Erstellen der neuen GENPAR Datei werden alle Anweisungen pro Schl sselbegriff Anweisung und erster Parameter von einer alten GENPAR Datei und der SYSPAR Datei bernommen Dies gilt auch f r die Kommentare auf Position 1 Die Reihenfolge der Anweisungen wird durch die alte GENPAR Anweisung bestimmt U21462 J Z125 7 49 Generierung des AVAS Systems Installation und Generierung Mit dem Generierungsprogramm k nnen keine Beschreibungen entfernt werden Beschrei bungen die pro Schl sselbegriff sowohl in der alten GENPAR Datei als auch in der SYSPAR Datei vorhanden sind werden nach festen Bearbeitungsregeln bernommen Bearbeitung der Benutzerbeschreibung USER Standardm ig wird die Beschreibung aus der SYSPAR Datei verwendet Wenn das Generierungsprogramm erkennt dass eine Kennwortverschl sselung im System stattfin det wird das Kennwort des jeweiligen AVAS Benutzers nicht aus der SYSPAR Datei verwendet sondern aus der alten GENPAR Datei Falls der Benutzer nicht in der alten GENPAR Datei definiert ist wird das Kennwort AVAS eingesetzt Bearbeitung einer Systemvariablen des Benutzers USVA
432. ion der Benutzer e die Funktionsberechtigungen e die Definition der Produktionspl ne e die Zuordnung der Maskenbibliotheken e die Zuordnung der Netzbibliotheken zu den Produktionspl nen e die Ablaufsteuerungen e Standardwerte f r die AVAS Funktionen und die AVAS Anweisungen und Variablen Mit der Auslieferung des AVAS Systems erh lt der Benutzer ein Muster mit der Beispielan wendung AVAS EXAMPLE Die Werte z B die Namen der Bibliotheken die den Schl s selw rtern zugeordnet sind k nnen entsprechend den individuellen Anforderungen ber nommen oder ge ndert und entsprechend erweitert werden F r die Namen der Bibliotheken Dateien und Jobvariablen gelten die Regeln des BS2000 OSD 18 U21462 J Z125 7 Installation und Generierung Generierung des AVAS Systems Die Generierungs Parameter in der Datei mit dem symbolischen Namen GENPAR k nnen im BS2000 OSD mit EDT nach dem vorgegebenen Muster ge ndert oder erweitert werden Das Schl sselwort der unterschiedlichen Generierungs Parameter muss dabei immer auf Spalte 1 der maximal 80 stelligen S tze beginnen Eine zweite Zeile einer Parameterbe schreibung wird verarbeitet wenn die vorhergehende Zeile mit einem Komma beendet wur de Kommentarzeilen k nnen verwendet werden Sie m ssen in Spalte 1 mit dem Zeichen beginnen Wenn die Generierungs Parameter in der Generierungsdatei aktualisiert sind muss mit der Prozedurdatei AVS GENSYSPAR Element in der Bibliothek S
433. ird eine CD ausgeliefert die AVAS SV V6 0A und AVAS DOORS V6 0 enth lt Diese CD enth lt folgende Funktionserweiterungen gegen ber V4 1C20 Nutzbarkeit des Status HOSTWAIT auch f r Nicht BS2000 Systeme Beim Start eines Server Jobs wird die Verf gbarkeit des Servers gepr ft Solange der Server nicht aktiv ist bleibt der Job im Status HOSTWAIT nicht mehr im Status ERROR wie das bis AVAS 5 0A der Fall war Korrekturen 4 AVAS 7 08 mit AVAS SV V4 1C10 C20 AVAS V7 0A kommuniziert mit den AVAS Servern V4 1010 C20 auf deren alter Schnitt stelle 5 AVAS 7 08 mit AVAS SV V6 0A AVAS V7 0A unterst tzt AVAS SV V6 0A mit dessen alter Schnittstelle 6 AVAS V7 0A mit AVAS SV V7 0A Parallel zu AVAS V7 0A wird eine CD ausgeliefert die AVAS SV V7 0A enth lt AVAS SV V7 0 enth lt gegen ber AVAS SV V6 0 neben einigen Korrekturen folgende Funktionserweiterung Bei CANCEL NET k nnen gestartete Serverjobs auch im jeweiligen System abge brochen werden U21462 J Z125 7 15 Installation des AVAS Systems Installation und Generierung AVAS DOORS Zus tzlich sind bei der Erstinstallation von AVAS DOORS folgende Punkte zu ber cksich tigen e AVAS DOORS V7 0A besteht aus Maskenbeschreibungs Dateien f r jede AVAS V7 0A Maske eine Um mit diesen Dateien arbeiten zu k nnen muss FHS DOORS installiert sein e Die Installation der Maskenbeschreibungs Dateien erfolgt im Rahmen der men gef hr ten Installation
434. it einer Serialisierung arbeitet nicht zur Endemeldung kommt und wenn ein oder weitere Funktionsprozesse mit dem gleichen Serialisierungsbegriff warten Das Ende der Serialisierung durch einen Funk tionsprozess kann nur in Ausnahmesituationen ausbleiben Eine dadurch m gliche Blocka de der Funktion SUBMIT NET wird durch die Anweisung MAX SERIAL LOCK verhindert Folgender Ablauf von serialisierten Anweisungen ergibt sich 1 Jeder Serialisierungsauftrag erh lt die mit der Anweisung MAX SERIAL LOCK festge legte Bearbeitungszeit Sie wird ermittelt nach der gr ten m glichen Verarbeitungszeit des Netzes Wenn die Zeit MAX SERIAL LOCK berschritten wird wird der Vorgang abgebrochen Der Benutzer wird zwangsabgemeldet und muss sich neu anmelden Hinweis Nach Ablauf von MAX SERIAL LOCK wird intern ein CANCEL USER HARD f r den Benutzer durchgef hrt um den Lock Zustand aufzuheben Es wird keine Anmeldesperre gesetzt Die Verarbeitung kann z B durch ein USER EXIT zu lange unterbrochen worden sein 2 Jeder wartende Serialisierungsauftrag erh lt bei Auftragstellung die mit der Anweisung MAX SERIAL WAIT festgelegte Wartezeit Sie wird ermittelt aus der durchschnittlichen Gr e eines Netzes und der Anzahl von Netzen die in der Spitzenzeit des Systems gleichzeitig ber eine serialisierte Anweisung verarbeitet werden m ssen Wenn die Zeit MAX SERIAL WAIT berschritten wird wird der Vorgang mit einer Mel dung abgebrochen U21462 J
435. iteten Bedingungseintrag wird AVS8521 MODIFY COND DESCRIPTION condname type RESULT ergebnis ausgegeben oder eine Fehlermeldung U21462 J Z125 7 337 REPEAT NET BATCH Anweisungen REPEAT NET Mehrfache Freigabe eines geplanten Netzes Die BATCH Anweisung REPEAT NET dupliziert ein geplantes und bereits freigegebenes Netz und gibt das Duplikat f r die Verarbeitung frei F r die Freigabe ist eine neue plan m ige Startzeit erforderlich Aus der neuen Startzeit wird der Netzname des Duplikats f r die Verarbeitung gebildet Sie kann mit dem Parameter NEW PLAN START vorgegeben werden Wenn keine neue Startzeit vorgegeben wird wird die Aufrufzeit des Kommandos verwendet Im Produktionsplan NPRLIB wird das Duplikat mit den Netzparametern unter dem neuen Namen zur vollst ndigen Dokumentation eingetragen Das Ursprungsnetz bleibt im Produktionsplan unver ndert erhalten und kann weiter als Eingabenetz f r REPEAT NET verwendet werden Dem Netz kann mit dem Parameter RUN CONTROL SYSTEM der Name eines anderen Ablaufsteuerungssystems zugewiesen werden Der Parameter RUN CONTROL SYSTEM entspricht dem Wert im Parameterfeld RUN CONTROL SYSTEM der Maske AVFO12 REPEAT NET NET NAME bk_ netname NEW PLAN START tt mm jj hh mm ss RUN CONTROL SYSTEM avak Der Parameter NET NAME muss vollqualifiziert angegeben werden Wenn der Parameter NEW PLAN START nicht angegeben wird werden das aktuelle Datum und die aktuelle Uhrzeit angeno
436. ixLNAM DS CL54 Ausgabe Parameter Bibliotheksname DS CL2 wird nicht verwendet pfixNNAM DS CL57 Ausgabe Parameter Jobname DS CL3 wird nicht verwendet pfixVERS DS CL3 Ausgabe Parameter Versionsnummer 001 pfixLTYP DS CL1 Ausgabe Parameter LMS Typ J DS CLA wird nicht verwendet pfixDATE DS CL8 Aktuelles Datum yymmdd pfixTIME DS CL6 Aktuelle Uhrzeit hhmmss pfixCMDN DS CL22 Kommandoname R ckgabe der RZ Routine an AVAS Eine evtl R ckgabe der RZ Routine an AVAS im Feld pfixRCS des Verst ndigungsberei ches wird nicht ausgewertet U21462 J Z125 7 83 RZ Exits im AVAS System Installation und Generierung 2 4 8 RZ Exit 1 Wenn eine S Prozedur ein BS2000 Job oder ein Server Job von der AVAS Ablaufsteue rung in die tempor re Datei ausgegeben wurde ruft AVAS die RZ Routine auf Bei diesem einmaligen Aufruf werden folgende Informationen bergeben abweichend von den im Verst ndigungsbereich beschriebenen Feldern pfixUSR X 40 kein AVAS Benutzername pfixCAL X 40 kein Kalendername pfixBKR X 40 Benutzerkreis des Netzes Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie folgt pfixNNAM Ausgabe Parameter Netzname pfixJIND Ausgabe Parameter Job Index pfixJNAM Ausgabe Parameter Jobname pfixRSTJ Ausgabe Parameter Job nach RESTART Y N pfixRSTA Ausgabe Parameter RESTART Anweisung Y N pfixUSID Eingabe Ausgabe Parameter Name der BS2000 Benutzerkennung des ENTER Aufrufs pfix
437. kationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie folgt pfixNNAM Ausgabe Parameter Netzname pfixEARL Ausgabe Parameter fr heste Startzeit pfixLATS Ausgabe Parameter sp teste Startzeit pfixLIFT Ausgabe Parameter Lebensdauer des Ereignisses Netzende pfixNTYP Ausgabe Parameter Angabe zur Serialisierung der Verarbeitung pfixNDSO Ausgabe Parameter Ma nahme bei nicht zeitgerechtem Start pfixRCSY Ausgabe Parameter Name des Ablaufsteuerungssystems R ckgabe der RZ Routine an AVAS Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden pfixOK EQU X 00 Die Funktion soll durchgef hrt werden pfixNO EQU X 04 Die Funktion soll nicht durchgef hrt werden 98 U21462 J Z125 7 RZ Exits im AVAS System Installation und Generierung 2 4 17 RZ Exit AVEX7102 Diese RZ Routine wird f r jede JCL Anweisung eines Auftrags aufgerufen Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie Ausgabe Parameter Netzname Ausgabe Parameter fr heste Startzeit Ausgabe Parameter sp teste Startzeit Ausgabe Parameter Lebensdauer des Ereignisses Netzende Ausgabe Parameter Angabe zur Serialisierung der Verarbeitung Ausgabe Parameter Ma nahme bei nicht zeitgerechtem Start Ausgabe Parameter Name des Ablaufsteuerungssystems Ausgabe Parameter Index aus der NPRLIB Ausgabe Parameter Jobname aus der NPRLI
438. kette durchgereicht wird kann in den Folgeprozessen die Jobvariable mit g ltigen Statusinformationen versorgt werden Die Ablaufsteuerung behandelt die Jobvariable wie die Auftrags Jobvariable eines Jobs der durch ein Strukturelement mit TYPE EXT als Prozedur gestartet wurde F r die Infor mationen T und A wird ein Ereignis gesetzt Es muss lediglich sichergestellt werden dass der letzte Prozess der Folge eine g ltige Statusinformation T oder A in der Job variablen ablegt und die Jobvariable vom Benutzer nicht gel scht wird Im Folgenden werden zwei Anwendungsf lle dargestellt siehe die zwei Bilder auf den fol genden Seiten U21462 J Z125 7 523 AVAS Schnittstelle f r externe Server AVAS SV Plattform bergreifende Jobsteuerung 1 Anwendungsfall Start und Kontrolle eines Ablaufs auf einem Server System ber AVAS BS2000 OSD mit AVAS Server Systeme AVAS Ablauf steuerung AVAS JV Schnittstelle ENTER PROCEDURE PROC PAR crtl jva name jva passw job parameter USER Be crtl jva COMMAND gt FILE MOD JV 4 A ERROR MOD JV Ablauf auf oret Server System USER PROZEDUR crtl jva result result FT MOD JV ST A RV2n text 524 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung AVAS Schnittstelle f r externe Server 2 Anwendungsfall Start und Kontrolle eines Ablau
439. kontrolle von Ser ver Jobs auf Seite 454 beschrieben Der BS2000 Agent AVSSINCM ist f r UNIX und Windows Systeme identisch Der AVAS Server AVSRECV ist f r UNIX und Windows Systeme plattformspezifisch Der Server f r Windows Systeme wird als Dienst installiert und gestartet Der Start von Ablaufen auf UNIX und Windows Systemen erfolgt auf die gleiche Art Auf jedem UNIX bzw Windows System auf dem AVAS Auftr ge abwickeln soll muss der Ser ver AVSRECV installiert und gestartet sein Die Adresse und Portnummer des Rechners m ssen in einer Konfigurationsdatei in der AVAS Kennung im BS2000 OSD eingetragen sein Die Zugangsberechtigung zu AVSRECV wird ber das Kennwort gepr ft das unter lt comm pw gt in der Konfigurationsdatei angegeben ist AVSRECV erzeugt den f r die Auftragsabwicklung auf dem Server verantwortlichen Kind prozess AVSSTHT U21462 J Z125 7 441 AVAS SV Plattform bergreifende Jobsteuerung F r jeden Server Job erzeugt AVSRECV einen Kindprozess AVSSTRT als pers nlichen Betreuer AVSSTHT ist programmtechnisch ein Teil von AVSRECV und m sste Kindpro zess von AVSRECV genannt werden Da er im Server System aber als eigener Prozess mit eigenen Aufgaben lauft erh lt er zur besseren Unterscheidung in der Beschreibung einen eigenen Namen Ab Seite 472 ist AVSSTRT n her beschrieben Ablaufsteuerung und kontrolle f r Server Jobs mit einem AVAS Server auf einem BS2000 System Jobs auf dem entfernt
440. kreise und Ablaufsteuerun gen zugegriffen werden die zum Zeitpunkt der Formatierung in der mit der Prozedur AVS GENSYSPAR Element in der Bibliothek SYSPRC AVAS 070 erzeugten System Parameterdatei vorhanden sind JRLDAT dateiname Pr fix des Dateinamens einer alternativen SAM Datei Not Journal datei in welche die Journals tze bei einem Fehler in der PAM Datei JRNDAT ausgegeben werden Beim Einrichten der Not Journaldatei durch AVAS wird der Dateiname vervollst ndigt indem Datum und Uhrzeit angef gt werden Das Pr fix des Dateinamens der Not Journaldatei muss eindeutig sein wenn mehrere AVAS Systeme auf einem Rechner gestartet werden ZDD Die UPAM ZD versucht sonst eine u U vorhandene Not Journaldatei eines zweiten Systems in die Journaldatei des ersten Systems einzumischen oder umgekehrt wenn eines der AVAS Systeme nicht gestartet wurde Wenn das zweite System gestartet wird tritt zudem beim Zugriff auf die Not Journaldatei des ersten Systems ein Fehler auf weil diese bereits er ffnet wurde 26 U21462 J Z125 7 Installation und Generierung Generierung des AVAS Systems HSTSYS dateiname Dateiname der History Datei ISAM Datei Bei der Reorganisation mit FUNKTION SJOUR werden in dieser Datei die History S tze der Netze und Jobs gespeichert 2 2 2 2 Definitionen der Benutzer Die System Parameter der Benutzer definieren alle Angaben die f r den Dialogbetrieb und f r die Anweisungen der Benutzer ben tigt we
441. kturelementes FU S mit der Operation EXECUTE direkt zum Subnetz verzweigt Kalender Angabe in der Netzbeschreibung Durch die Angabe eines Kalendernamens in der Netzbeschreibung kann ein Netz mit einem beliebigen Kalender geplant werden Bisher lief die Planung ber den Kalender der dem Benutzerkreis zugeordnet war siehe Handbuch AVAS Anweisungen 1 U21462 J Z125 7 Anderungen gegen ber der vorigen Handbuchausgabe User Exit bei CREATE NET DESCRIPTION MODIFY NET DESCRIPTION und EDIT JOB Durch RZ Exits beim Abspeichern der Netz und Jobbeschreibungen kann f r diese Objekte eine Historie gef hrt werden siehe Handbuch AVAS Anweisungen 1 Zyklische Netzplanung Netze k nnen ab einem Anfangsdatum zyklisch geplant werden Dabei wird ein An fangsdatum und eine Anzahl von Tagen als Zyklus festgelegt siehe Handbuch AVAS Anweisungen 1 Condition TIM mit absoluter Wartezeit Bei der Bedingung TIM COND TYPE TIM kann nun auch eine absolute Wartezeit an gegeben werden siehe Handbuch AVAS Anweisungen 1 Verkn pfung Symdat bei CREATE PLAN NET F r das Arbeiten mit Symdats werden Verkn pfungen zugelassen Dies gilt f r die Auswahl der zu planenden Netze die Bildung der Netzstruktur Siehe Handbuch AVAS Anweisungen 1 S Variable neue Werte bei CREATE PLAN NET Bei CREATE PLAN NET werden folgende AVAS Systemvariable versorgt S 099 PLAN START des Netzes als Symdat S 100 Auswahl der
442. kturen Journalsicherung Not Journaldatei 4 3 Datenstrukturen der Journalsicherung und der Not Journaldatei Aufbau der S tze Der Aufbau der S tze in der Sicherungsdatei der Journals tze wird beschrieben um dem Benutzer die Erstellung eigener Auswertungsprogramme zu erm glichen Die S tze in der Sicherungsdatei und in der Not Journaldatei haben den gleichen Aufbau F r die Interpretation der Datensatz Inhalte steht der Makro AVASJRN zur Verf gung Zugriffsmethode SAM Adressierung der S tze SYSTEM ID L 7 Benutzerkreis L 5 Netzname L 32 Datum L 8 Uhrzeit L 6 laufende Nummer L 2 Maximale Satzl nge 428 Byte Maximale Datenl nge 316 Byte Format der S tze Byte 0 und 1 Satzl nge H einschlie lich Satzl ngenfeld Byte 2 und 3 reserviert X 0000 Byte 4 bis 43 Vorspann Journalsicherung Byte 44 bis 111 Vorspann Journalsatz Byte 112 bis 427 Datensatz Der Aufbau der Journals tze wird durch den Makro AVASJRN beschrieben Jeder Satz besteht aus einem festen Teil 112 Byte und einem Datenteil mit variabler L nge maximal 316 Byte U21462 J Z125 7 187 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Fester Teil Makroaufruf F3N AVASJRN amp PRE VERSION 070E EQUSYES Das Satzl ngenfeld ist auf Wortgrenze ausgerichtet Der Rest ist mit Leerzeichen aufge f llt Datenbereich Zur Identifikation des Datenbereichs dient der Satzschl ssel F r di
443. laufsteuerungen definiert sind e Es wird keine Kopie der Ablaufdatei und der Journaldatei erstellt e Die Werte in der Ablaufdatei werden nicht mit den Werten in der Journaldatei vergli chen Es wird nur gepr ft ob die alte AVAS SYSTEM ID und der alte Name der ersten Ablaufsteuerung mit den Werten in der Journaldatei bereinstimmen e Die neuen Namen der Ablaufsteuerungen werden in Jobvariablen zwischengespei chert Es wird nicht kontrolliert ob die Inhalte w hrend des Ablaufes der Prozedur ver ndert werden 62 U21462 J Z125 7 Installation und Generierung AVAS DOORS 2 3 AVAS DOORS Installation und Konfiguration AVAS DOORS ist keine Anwendung im eigentlichen Sinn sondern besteht aus etwa 100 Maskenbeschreibungsdateien f r jede Maske von AVAS eine FHS DOORS verwen det diese AVAS DOORS Masken um die AVAS Masken grafisch abzubilden Wenn FHS DOORS gestartet eine Sitzung er ffnet und eine Verbindung zu AVAS auf dem BS2000 Host aufgebaut wird dann werden die AVAS DOORS Masken automatisch gela den und angezeigt Mit AVAS DOORS steht unter FHS DOORS eine grafische Oberfl che f r AVAS im BS2000 OSD zur Verf gung Zu diesem Zweck wurden alle alohanumerischen FHS Masken von AVAS in grafische AVAS DOORS Masken konvertiert und f r eine einfachere Nutzung anschlie end noch optimiert um die Vorteile von grafischen Oberfl chen besser ausnutzen zu k nnen Dabei wurden die AVAS DOORS Masken aber nur so weit ver n de
444. ld AVSMGCT ist und AVSMGCT einen Wert ungleich 0 enth lt stehen dem Programm die letz ten Meldungen nicht zur Verf gung Folgende Felder werden f r jede Meldung ausgegeben AVSWMSGK AVAS Meldungsschl ssel AVSWMSGN AVAS Meldungsnummer AVSWMSGS Wenn dieses Feld die Kennzeichnung AVSWQNTL enth lt steht im n chs ten Tabelleneintrag keine neue Meldung sondern die Fortsetzung der aktu ellen l nger als 125 Zeichen AVSWMSGT AVAS Meldungstext F r die Programmierung sind im Makro bzw COPY Element weitere Einzelheiten in den Definitionen beschrieben Die Meldungsausgabe kann unterdr ckt werden wenn das Feld AVSWFILE Dateiname gel scht und AUSWMGCT Anzahl auf Null gesetzt werden U21462 J Z125 7 385 Assembler Schnittstelle Programmschnittstelle von AVAS 10 3 Assembler Schnittstelle 1 Aufruf der Assemblerschnittstelle F r Assembler Programme wird folgende Registerbelegung ben tigt Register 1 Adresse einer Parameterleiste die 3 Adressen enth lt 1 Adresse Kommunikationsbereich COMAREA 2 Adresse Ergebnisbereich OUTAREA 3 Adresse Arbeitsbereich WRKAREA Register 13 Adresse eines 18 Wort gro en Registersicherstellungsbereiches Register 14 Adresse f r den R cksprung aus AVAS zum Benutzerprogramm Register 15 Entry Adresse AVASBASS des AVAS Verbindungsmoduls AVSBCALL Nach der Bearbeitung enthalten die beiden rechten Bytes des Registers 15 den Wert des Feldes AVSRFDBK Der Assembler Aufruf
445. le Speichern der Protokolle isses kac EEN eRRY XR eR Sammeln der Protokolle exor e A REOR Rm EE Bearbeiten der Protokolle bersicht der Protokollstatus bei Anweisungen Sysiemopiimierung aaa CbRECCERERCDURRCUORI EE det Systemoptimierung bei BATCH Betrieb Sicherung und Reorganisation i Reorganisation der AVAS Benutzerdateien Reorganisation der Ablaufdatei und der Journaldatei Reorganisation der Protokolldatei Ablauf des Reorganisationsprogramms ii Anweisungen f r das Reorganisationsprogramm Sichern der Journale und Protokolle und Ausgabe der Journalliste Sichern der Journals tze i Ausgabe der Journalliste 666666666606666 nn Sichern der Protokolldaten eee Datenstrukturen der Journalsicherung und der Not Journaldatei Aufbau der Satze u une aaa sauna an an nn nn Journals tze der Anweisungen Satzaufbau des festen Teils der Journals tze Satzaufbau des variablen Teils der Journals tze Aufbau der Hist ry Datel 3 e Dienstprogramm AVAS QUER Arbeiten mit AVAS QUER een Voraussetzungen f r den Start von AVAS QUER Starten von AVAS QUEM sa e ru REX a SR RE ER Anweisungen eingeben
446. lease note that all company references and copyrights in this document have been legally transferred to Fujitsu Technology Solutions Contact and support addresses will now be offered by Fujitsu Technology So lutions and have the format rs fujitsu com The Internet pages of Fujitsu Technology Solutions are available at http ts fujitsu com and the user documentation at htip manuals ts fujitsu com Copyright Fujitsu Technology Solutions 2009 Hinweise zum vorliegenden Dokument Zum 1 April 2009 ist Fujitsu Siemens Computers in den alleinigen Besitz von Fujitsu bergegangen Diese neue Tochtergesellschaft von Fujitsu tr gt seit dem den Namen Fujitsu Technology Solutions Das vorliegende Dokument aus dem Dokumentenarchiv bezieht sich auf eine bereits vor l ngerer Zeit freigegebene oder nicht mehr im Vertrieb befindliche Produktversion Bitte beachten Sie dass alle Firmenbez ge und Copyrights im vorliegenden Dokument rechtlich auf Fujitsu Technology Solutions bergegangen sind Kontakt und Supportadressen werden nun von Fujitsu Technology Solutions angeboten und haben die Form ts fujitsu com Die Internetseiten von Fujitsu Technology Solutions finden Sie unter http de ts fujitsu com und unter Attp manuals ts fujitsu com finden Sie die Benutzerdokumentation Copyright Fujitsu Technology Solutions 2009
447. leiben im Status RUNNING e Die mit BS2000 OSD oder einem Server System ausgefallenen Jobs erhalten den Status ERROR Folgende Ausfallszenarien sind aus Sicht von AVAS zu betrachten 1 Ausfall von AVAS im BS2000 OSD AVAS muss neu geladen werden und ermittelt die aktuelle Produktionsumgebung e BS2000 und Server bzw mySAP com Jobs die zum Ausfallzeitpunkt im Status RUNNING waren und nach dem Neustart noch nicht beendet sind behalten den Status RUNNING e BS2000 und Server bzw mySAP com Jobs die zum Ausfallzeitpunkt im Status RUNNING waren und nach dem Neustart beendet sind erhalten den Status nor males oder abnormales Jobende ENDED ERROR e BS2000 und Server bzw mySAP com Jobs die gestartet werden sollten w hrend AVAS nicht verf gbar war werden entsprechend der Einstellung f r Versp tungen NET DELAY SOLUTION in der Netzbeschreibung behandelt e Server Jobs die in der Zwischenzeit zu Ende gelaufen sind und ihre LOG Dateien nicht an den CENTRAL Task bergeben konnten laufen entsprechend der Einstel lungen f r die Programmaufrufe SIGNAL oder TRANSFER auf normales oder abnormales Jobende ENDED ERROR U21462 J Z125 7 514 AVAS SV Plattform bergreifende Jobsteuerung Verhalten im Fehlerfall Die LOG Dateien k nnen nachtr glich mit dem AVAS Kommando ADD JOB LOG in die AVAS Bibliothek bernommen werden 2 Ausfall des BS2000 OSD und damit auch von AVAS AVAS wird mit dem BS2000 OSD neu geladen und e
448. lementen CL54 CL3 CL3 CL11 NJ2VA CL30 CL32 CL3 NJ2VA L NJ2VA CL20 OF NJ2A DS DS DS DS ORG DS DS DS ORG DS DS EQU J2FCN J2VPOS J2VLEN J2VPAS J2CJN J2CNN J2CIX NJ2L U21462 J Z125 7 Externe Erstellung von AVAS Elementen AVASNET RECORD J3 PREFIX N MFCHK MF C C PREFIX N 0 MACID J3 0 DMACID J3D C SUPPORT C D DS Op HHE PREFIX N MACID J3 Here DS Op DS H PLAM RECORD LENGTH DS PLAM RESERVED PLAM SK DS C PLAM RESERVED PLAM SA DS CL2 RECORD KEY DS DESCRIPTION FUNCTION CODE DS X DESCRIPTION TYPE CODE D GE RESERVED DS EL INDEX DS CL30 AME DS cL2 RESERVED PARAMETERS x FUNCTION J TYPE STD MOD EXT P STD MOD EXT EXX S X STD MOD EXT DS CL8 JOB USER ENTER USER ID DS CL8 JOB ACCOUNT ENTER ACC NUMBER DS CL8 JOB CLASS ENTER JOB CLASS DS CL8 JOB LOG DS CL19 JOB PASSWORD D CLS RESERVED DS CL128 JOB PARAMETER DS 0CL54 JOB CAT CATID IN JVA DS CL QUOTE OF CATID EQU X 7D CATID QUOTE JOB EQU X 7D CATID QUOTE NET DS CL4 JOB CAT STRING OF CATID DS CL49 RESERVED DS CL10 RESERVED USED ONLY WHEN RCIPTION TYPE MOD STD EXT EXX FUNCTION J P X J P P XJ P EQU NJ3A RECORD LENGTH MINIMUM DS OCL54 NAME OF ENTER FILE U21462 J Z125 7 J3A J3SLEN J3SSL J3FUNC J3TYPE
449. lgende Zeilen als Startup Script ein SET LOGON PARAMETERS USER AVASD ACCOUNT 123 PASSWORD amp Kennwort SECRET CALL PROCEDURE NAME START AVAS LOGOFF NOSPOOL U21462 J Z125 7 65 Installation und Generierung Erzeugen einer Parameterdatei f r FHS DOORS Starten Sie FHS DOORS durch Doppelklick auf die FHS DOORS Ikone W hlen Sie die Funktion Sitzung Neu Die Dialogbox Neue Sitzung wird ge ffnet W hlen Sie in der Liste Ressourcenpfad das Verzeichnis aus in dem die AVAS DOORS Masken abgelegt sind z B CAAVSDOORS Geben Sie in die Eingabefelder der Emulations Parameter Folgendes ein Dateiname Dateiname der verwendeten Terminal Emulation z B C FHSDOORS DOORS_EM DOORS_EM EXE Parameter Parameter f r die Terminal Emulation oder Dateiname der unter 1 erstellten Parameterdatei f r die Terminal Emulation z B C FHSDOORS DOORS_EM AVASD DRE Klicken Sie auf den Aktionsknopf OK um die Einstellungen zu berneh men W hlen Sie die gew nschten Einstellungen im Men Konfiguration W hlen Sie die Funktion Sitzung Sichern als um die Sitzungs Parameter in einer Parameterdatei zu speichern W hlen Sie die Funktion Sitzung Beenden um FHS DOORS zu beenden Erzeugen einer Ikone zum Direktstart einer Sitzung Kopieren Sie die FHS DOORS Ikone Funktion Datei Kopieren des Programm Managers ndern Sie die Programmeigenschaften Funktion Datei Eigenschaften des Pro gr
450. lgt aufgerufen avssinjv L tl text l t Der Inhalt der Jobvariablen wird nach deren Modifikation nach stdout ausgegeben Angabe wahlfrei text Text maximal 55 Byte der in den Benutzerbereich der Auftrags Jobvariable geschrieben wird text ist gem den Regeln f r Argumente der Server Shell zu ver sorgen Wenn das erste Textwort mit RV n 0 lt n lt 3 beginnt beeinflusst es das Restart Verhalten des Netzes siehe Handbuch AVAS Funktionen 2 Der Text wird bei Jobende in die Journaldatei geschrieben AVSSINJV wird auch von der Ablaufsteuerung unterst tzt Wenn ein in AVAS verwaltetes Server Skript die AVAS Anweisung AVJ mit einem Text enth lt erzeugt die Ablaufsteue rung daraus avssinjv text Mit dem Programm AVSSINJV kann nur der AVAS USER Bereich ver ndert werden Wenn der Benutzer eine JV Datei w hrend des Ablaufs eines Jobs ver ndert belegt oder l scht kann der ordnungsgem e Ablauf nicht kontrolliert und zum BS2000 OSD bertra gen werden Jeder Fehler den AVSSINJV feststellt und ber die Meldung AVSX070 meldet f hrt zum Status ERROR beim Server Job Das Programm avssinjv exe liegt bei Windows Systemen im Verzeichnis AVAS_BINPATH auf UNIX Systemen im Verzeichnis bin unterhalb des Installations verzeichnisses U21462 J Z125 7 11 4 1 492 AVAS SV Plattform bergreifende Jobsteuerung Programme des AVAS Servers Wenn AVSSINJV in anderen Jobs gestartet wird tritt ein inte
451. lle F r die zentrale Speicherung der Protokolle zum Zeitpunkt des Jobablaufs steht eine DCAM Anwendung zur Verf gung Die Anwendung besteht aus mehreren DCAM Pro grammen die miteinander kommunizieren Dem zentralen Prozess CENTRAL werden durch die Programme SIGNAL und TRANSFER die Protokolle signalisiert und zur zentra len Speicherung bertragen 136 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb Prozess CENTRAL CENTRAL ist eine mehrfach benutzbare DCAM Anwendung CENTRAL besteht aus einer Prim rtask und einer bestimmten Anzahl von Sekund rtasks Die Prim rtask stellt die Betriebsmittel des zentralen DCAM Prozesses bereit und steuert die Anwendung Die Sekund rtasks bernehmen die Anforderungen von den DCAM Programmen und speichern die Protokolle zentral ab Neben den zentralen Zugriffsprozessen ZDs wird auf dem gleichen Rechner und unter der gleichen Benutzerkennung der CENTRAL Prozess per ENTER Aufruf gestartet CENTRAL meldet sich als besonderer Prozess analog AVAK bei den ZDs an Programm SIGNAL SIGNAL ist ein einfach benutzbares DCAM Programm Unmittelbar nach der LOGON Anweisung und der ASSIGN SYSOUT Zuweisung wird SIGNAL als erstes Programm in einem AVAS Job geladen Es ermittelt die AVAS Jobiden tifikation und den Namen der Datei mit den SYSOUT Informationen und sendet diese zusammen mit weiteren Steuerungs Parametern an CENTRAL Probleme werden von SIGNAL ggf in einer Progra
452. llungsregeln Prozedur zum Erstellen von GENPAR Beschreibungen Einrichten und Formatieren der AVAS Dateien Benutzerdateien und ihre symbolischen Namen AVAS Bibliotheken x 1 x RR RERO ER RAO AVAS Versionswechsel mit ABLDAT und JRNDAT Inhalt wech sech sech sch sch sch m m m KEKESKENCRE 2 1 1 2 1 2 2 1 3 2 1 4 21 5 2 2 1 2 22 2221 2222 2 2 2 3 2 2 2 4 2 225 2 2 2 6 2 2 8 2 2 4 2 2 4 1 2 2 4 2 2 2 5 225 1 2 2 5 2 2 2 5 3 U21462 J Z125 7 Inhalt 23 AVAS DOORS Installation und Konfiguration os 63 2 3 1 Hard und Software Voraussetzungen es 63 2 3 2 Installation von AVAS DOORS oni 64 2 3 9 Konfiguration von AVAS DOORS sir EY e a a I ERU PX 65 2 3 4 Konfigurationen im BS200Q C D iustas dames x EAE EROR ae 67 2 4 Rz Exits IN AVAS SSVSIBIW serien 68 2 4 1 Einbinden der RZ Routinen in AVAS 74 2 4 2 Einbindern von MARENAV uso is REUS RR a CERAM RATES 76 2 4 8 Anschluss von RZ Routinen neben MARENAV i 76 2 4 4 Verst ndigung zwischen AVAS System und RZ Routinen i 78 2 4 4 1 Veretandigungsbbereleli a AE ded NEEN REOR rau 78 2 4 4 2 Kommunikationsbafsiehe A A EAR RE EEN RAN AEN ee A d EC SEN 80 2 4 5 HZ Exit AVESDODT nd AVEX0002 2a are 81 2 4 6 FEE AVEX OT ana anreisen 82 2 4 7 HEEL AVEO IO e 83 2 4 8 84 2 4 9 BES E ea d Or a
453. m Dialog Ablauf und Ergebnis der BATCH Funktionen entsprechen den AVAS Dialogfunktionen und sind dort beschrieben Eine BATCH Anweisung f hrt zur sofortigen Bearbeitung und zur Ausgabe eines Proto kolls Dies entspricht den Dialogfunktionen Beschaffen einer bersicht Markieren aller Elemente mit Y und der Operation EXECUTE Markierungen und Operationen k nnen nicht eingegeben werden Bei allen BATCH Anweisungen bei denen der Parameter PERIOD NAME nicht zugelas sen ist muss deshalb der Parameter zur Elementauswahl angegeben werden NET NAME ELEMENT NAME usw Bei einigen BATCH Anweisungen k nnen jedoch die erforderlichen Parameter von ausge w hlten Maskenfeldern mitgegeben werden Abweichungen im Funktionsumfang gegen ber den Dialogfunktionen sind bei den einzel nen BATCH Anweisungen beschrieben Die Vorgabe des Parameters RUN CONTROL SYSTEM wird eliminiert wenn die geforder te Anweisung diesen Parameter nicht zul sst Bei einer nachfolgenden Anweisung die den Parameter RUN CONTROL SYSTEM verlangt wird der Standardwert angenommen wenn der Parameter nicht vorgegeben ist Entsprechendes gilt f r den Parameter CANCEL TYPE U21462 J Z125 7 311 BATCH Funktionen Folgende BATCH Anweisungen sind zugelassen ADD JOB LOG CANCEL NET CHANGE NET DESCRIPTION COPY ELEMENT CREATE PERIOD CREATE PLAN NET CREATE PROD JOB CREATE PROD NET DELETE DOCUMENT DELETE JOB DELETE JOB LOG DELETE NET DESCRIP
454. m Parameter SYSPAR gegen ber den urspr nglich verwendeten Generierungs Para metern GENPAR Mit der Prozedurdatei AVS CREATE GENPAR Element in der Bibliothek SYSPRC AVAS 070 ist es m glich aus einer GENPAR Datei und einer SYSPAR Datei eine neue GENPAR Datei zu erstellen Beim Erstellen der neuen GENPAR Datei werden die Generierungsanweisungen GEN Anweisungen USER USVAR und FUTABnnn aus der alten GENPAR Datei und der SYSPAR Datei ber cksichtigt Standardm ig werden USER USVAR und FUTABnnn aus der SYSPAR Datei bernommen Alle anderen GEN Anweisungen werden von der alten GENPAR Datei unver ndert in die neue bernommen Syntax der Generierungsanweisung und Erstellungsregeln Der Anweisungsname aller Beschreibungen muss auf Position 1 stehen Parameter in Fortsetzungsbeschreibungen sollten ab Position 2 definiert sein Beschreibungen mit glei chen Anweisungsnamen m ssen nacheinander definiert werden sie d rfen nicht durch einander folgen Die Bearbeitung der GEN Anweisungen die aus der GENPAR Datei ber cksichtigt werden USER USVAR und FUTABnnn d rfen nicht mit einer Fortsetzungszeile beschrieben wer den Beschreibung eines Benutzers USER name kennw bkr futab t K2 Bezeichnung Position Beschreibung von bis USER 01 08 Generierungsanweisung 09 11 Trennzeichen zwischen Anweisung und Parameter 12 12 Klammer auf Beginn der Parameter name 13 20 Benutzername der generiert werden soll
455. m Rahmen der Installation von AVAS SV installiert Neben den Programmen avasr3 und edusini werden noch Beispiele f r Konfigurationsdateien und Job Beispiele mit ausgeliefert Die Konfigurationsdateien und die Test Jobs m ssen an die entsprechende Anwender Umgebung angepasst werden Bei der UNIX Variante von avasr3 ist die RFC Bibliothek die f r die my SAP com Kommuni kation notwendig ist im Programm mit eingebunden Bei der Installation von avasr3 auf einem Windows System muss die Bibliothek 11567232 011 der entsprechenden mySAP com Version installiert werden Diese Bibliothek ist auf der mSySAP com Presentation CD im Verzeichnis SDK NT 1386 im CAR File Rfc car enthalten Das CAR File wird mit dem Windows Shell Kommando CAR xvf Rfc car entpackt Anschlie end muss die Bibliothek 1ibrfc32 d11 in das Ver zeichnis C WINNT SYSTEM32 kopiert bzw der Suchpfad entsprechend erweitert werden Konfiguration f r den mySAP com Zugriff Eingabedateien Zur Kommunikation mit dem mySAP com System verwendet das Programm avasr3 die RFC Schnittstelle von mySAP com RFC Remote Function Call Zur Anmeldung an mySAP com werden RFC spezifische Parameter und die mySAP com Benutzerdaten ben tigt F r die RFC spezifischen Parameter liest die RFC Bibliothek die Datei saprfc ini Diese Datei muss entweder im aktuellen Arbeitsverzeichnis stehen oder ihr vollst ndiger Pfad muss in der Umgebungsvariablen RFC INI definiert sein Eine saprfc ini Datei s
456. me port nr comm pw lt 4 port nr SERVER NAME server name SERVER PW USER PASSWORD JOB CAT STD server name server pw AVSRECV AVAS Server SERVER JOB server name server pw lt 4 port nr comm pw AVSSINCM AVAS Agent Konfigurations datei Startprozedur AVSSINCM Startprozedur f r Ablaufsteuerung SERVER PROC NAME CONFIG FILE NAME Bild 11 Zusammenh nge der Definitionen im BS2000 OSD und im Server System U21462 J Z125 7 Einsatzvorbereitung AVAS SV Plattform bergreifende Jobsteuerung Bestimmen der Server Namen f r jeden Benutzerkreis Ein Server Name ist eine symbolische Bezeichnung daf r auf welchem Rechner host und unter welcher Benutzerkennung Userid ein Server Job ablaufen soll Den Server Namen nimmt AVAS bei UNIX oder Windows Jobs aus der Netzbeschreibung Maske AVN009 wenn der Name hier angegeben ist den Generierungs Parametern Angabe server name f r den Benutzerkreis wenn STD in der Netzbeschreibung angegeben ist derStartprozedur des AVAS Agenten AVSSINCM SERVER NAME wenn sowohl in der Netzbeschreibung als auch in den Generierungs Parametern f r Server Name STD angegeben ist Den Servernamen nimmt AVAS bei BS2000 Jobs aus der Netzbeschreibung Maske AVN00
457. meldung zugeord net Das Kennwort des ber AVAS USER ID definierten Benutzers ist hier anzugeben Die Anweisung muss nur bei FUNKTION CREATE angegeben werden USER PASSWORD password Das Kennwort des Benutzers das ihm ber die System Parameter zugeordnet ist ist anzu geben de x 8 Zeichen U21462 J Z125 7 301 PLANNED NET MODIFICATION Report AVAS Reports 7 3 PLANNED NET MODIFICATION Report Beim PLANNED NET MODIFICATION Report werden folgende REPORT Anweisungen verarbeitet REPORT NAME PLANNED NET MODIFICATION FUNKTION fALL CREATE SORT PRINT AVAS SYSTEM ID string SYSTEM PASSWORD STD kennwort AVAS USER ID avuser USER PASSWORD kennwort NET NAME OWN ALL x bk_ bk_netname PERIOD NAME period OUTPU ORK FILE full filename OUTPU ORK LINK full filename OUTPUT REPORT FILE full filename OUTPUT REPORT LINK full filename END Wenn REPORT Anweisungen angegeben werden die nur vom OUT OF PLAN Report ben tigt werden werden diese ignoriert Wenn unzul ssige oder fehlerhafte Anweisungen gefunden werden werden diese als unzul ssig protokolliert und die Verarbeitung der Eingaben wird abgebrochen In der ber FUNKTION PRINT zu erzeugenden Liste werden die folgenden Daten der Netze ausgewiesen NET NAME Der vollst ndige Netzname mit den Erweiterungen Datum und Uhrzeit wie er bei der AVAS Funktion CREATE PLAN NET gebildet wurde STATE Der aktuelle Status des Netzes
458. mit einer Meldung abgewiesen werden Wenn die RZ Routine im Feld RETURNCODE einen Fehler zur ckmeldet wird im Feld MSG der Benutzermaske eine Fehlermeldung aus gegeben Der Ausgang AVEX6802 wird aktiviert bevor die Werte der AVAS Variablen P nnn modifi ziert werden CMD CONTINUE in der Benutzermaske 5 Der RZ Routine werden die Eingaben aus der Benutzermaske zur Uberpr fung bergeben U21462 J Z125 7 72 Installation und Generierung RZ Exits im AVAS System RZ Exit AVEX7101 geplantes Netz freigeben Die Freigabe eines Netzes kann kontrolliert protokolliert zugelassen oder zur ckgewiesen werden Die Information Netzfreigabe kann an andere Programmsysteme weitergegeben werden z B MAREN um die Bereitstellung der Datentr ger zu veranlassen Wenn zum Beispiel in einem Rechenzentrum der Ablauf von Produktionsbereichen ber Informationen gesteuert wird die dem AVAS System nicht bekannt sind oder bekannt gemacht werden k nnen dann hat der Benutzer die M glichkeit den Start von Produk tionsbereichen zu unterbinden Der Ausgang AVEX7101 wird aktiviert wenn AVAS die Freigabe des Netzes gepr ft und keine M ngel festgestellt hat das Netz ist in der Ablaufdatei noch nicht vorhanden alle im Netz aufgerufenen Jobs sind vorhanden Das Element des Netzes in der NPRLIB ist gesperrt die Jobs in der JMDLIB und der JMDSYS sind nicht gesperrt Wenn eine Netzgruppe freigegeben werden soll wird f r jedes Netz der Gruppe d
459. mm Pflichtparameter Standardwert f r den Parameter LATEST START in den Netzstrukturbeschreibungen Bei der Netzplanung ersetzt der angegebene Wert den Wert NONE bei den Beschrei bungen vom Typ FUzJ P X U21462 J Z125 7 39 Generierung des AVAS Systems Installation und Generierung DEFAULT LATEST OCCURESttt hh mm Pflichtparameter Standardwert f r den Parameter LATEST OCCURE in den Netzstrukturbeschreibun gen Bei der Netzplanung ersetzt der angegebene Wert den Wert NONE bei den Beschreibungen vom Typ FU C DEFAULT OCCURE TIME ttt hh mm Pflichtparameter Standardwert f r den Parameter OCCURE TIME in den Netzstrukturbeschreibungen Bei der Netzplanung ersetzt der angegebene Wert den Wert NONE bei den Beschrei bungen vom Typ FU W Definition von Standardwerten f r die Strukturanzeige von Netzen Standardwert f r die Anzeige von nicht zur Verarbeitung kommenden Strukturelementen bei den Anweisungen CREATE PLAN NET SHOW PLAN NET SUBMIT NET REPEAT NET SHOW NET STATUS MODIFY SUBMIT NET MODIFY SUBMIT JOB und RESTART NET DEFAULT DISPLAY DUMMY YES NO YES Strukturelemente im Status NO PLAN NO SUBMIT und DELETED werden ber die Struktur mit angezeigt NO Strukturelemente im Status NO PLAN NO SUBMIT und DELETED werden nicht angezeigt Bei den Anweisungen HOLD NET und RESUME NET werden stets alle Strukturelemente angezeigt da Netze auch bei den nicht zur Verarbeitung kommenden Strukturelementen angehalten werde
460. mm Jobvariablen mitgeteilt Wenn weitere Protokolle z B SYSLST zentral gespeichert werden sollen ist f r jedes Protokoll das SIGNAL Programm aufzurufen Programm TRANSFER TRANSFER ist ein einfach benutzbares DCAM Programm Es wird entweder im AVAS Job unmittelbar vor der LOGOFF Anweisung als letztes Pro gramm geladen oder es l uft nach Jobende angesto en durch AVAS als eigenst ndiger Job ab TRANSFER ermittelt die AVAS Jobidentifikation und sendet diese zusammen mit den ggf angegebenen Parametern an CENTRAL Wenn die Informationen korrekt sind fordert CENTRAL das TRANSFER Programm zur bertragung der Protokolldaten auf Wenn im TRANSFER Programm Probleme auftreten werden diese ggf in einer Programm Job variablen gemeldet 3 3 4 1 Speichern der Protokolle Die Protokolle der Jobs die unter der Kontrolle von AVAS abgelaufen sind werden in einer PLAM Bibliothek gespeichert Der BS2000 Dateiname der Bibliothek wird ber den Gene rierungs Parameter LOGSYS beschrieben U21462 J Z125 7 137 Administrationsaufgaben im Betrieb Administration von AVAS Ein Protokoll wird in die Bibliothek eingetragen e als JOBLOG Satz in einem Element vom Typ S und e als Datensammlung in einem Element vom Typ D Der Name eines Protokollelements setzt sich aus folgenden Teilen zusammen Typ S bk netzname plandatum planzeit catid tsn datum Typ D bk netzname plandatum planzeit catid tsn datum nn Bedeutung und Lange der Namensteile
461. mmen Wenn der Parameter RUN CONTROL SYSTEM nicht angegeben wird wird der im Netz festgelegte Name der Ablaufsteuerung verwendet Protokoll der Verarbeitung F r das freigegebene Netz wird AVS8521 REPEAT NET netname datum uhrzeit RESULT ergebnis ausgegeben oder eine Fehlermeldung Im Fehlerfall kann der Wert f r datum uhrzeit fehlen Der Wert f r netname ist der Name des Eingabenetzes und der f r datum uhrzeit das Planungsdatum des freigegebenen Netzes auch Bestandteil des neuen Netznamens 338 U21462 J Z125 7 BATCH Anweisungen RESTART NET RESTART NET Wiederanlauf eines Netzes nach Fehler Mit RESTART NET k nnen Netze bearbeitet werden deren Verarbeitung wegen eines Feh lers unterbrochen wurde das Netz hat Status ERROR oder in denen mindestens ein Strukturelement bereits den Status ERROR hat das Netz hat Status CALLED FOR ERROR Der Parameter NET NAME muss angegeben werden der Parameterwert muss vollqualifi ziert angegeben werden RESTART NET NET NAME S bk netname RUN CONTROL SYSTEM avak RESTART VARIANT 1 2 3 ERROR INDEX index ERROR NAME f jobname condname Der Parameter ERROR INDEX muss angegeben werden wenn mehr als ein Strukturele ment im Status ERROR im Netz vorhanden ist Wenn sich auf der im Parameter ERROR INDEX angegebenen Indexstufe mehrere Elemente im Status ERROR befinden muss auch der Parameter ERROR NAME angegeben werden Das zu bearbeitende Strukturelement im Sta
462. mten Position einen gew nschten Wert annehmen muss damit die Bedingung des Strukturelementes erf llt ist CONDITION TEXT Kurzbeschreibung des Strukturelements 528 U21462 J Z125 7 Fachw rter CONDITION TYPE Art des Strukturelements das eine Bedingung beschreibt NET JOB RES VAL JVA TIM Entsprechend wird gesprochen von Condition NET Condition JOB Condition RES OURCE Condition VAL UE Condition JVA Condition TIM CONDITION VALUE Wert eines Bedingungseintrages oder einer Jobvariablen DELAY SOLUTION Ma nahme f r nicht zeitgerechten Netzstart DOCLIB Linkname f r die Bibliothek der Dokumentationselemente DOCSYS Linkname f r die zentrale Bibliothek der Dokumentationselemente DUE Taste gleichbedeutend mit ENTER Taste siehe dort EARLIEST START vorgesehene aufgel ste Startzeit des Netzes wird bei CREATE PLAN NET gebildet und kann mit MODIFY PLAN NET und SUBMIT NET ver ndert wer den ist Suchkriterium bei der Selektion von Netzen ber den Operanden PERIOD NAME aber kein Namensbestandteil ENTER FILE In dieser Datei wird die JCL der nicht von AVAS verwalteten Jobs abgelegt Jobs mit JOB TYPE EXT ENTER PARAMS Angabe ob die Versorgung der ENTER Parameter aus der Netzbeschreibung oder den Jobs heraus erfolgen soll ENTER Taste l st die Ubertragung der Daten einer Maske an AVAS aus EXTERNAL FILE Name einer externen PLAM Bibliothek oder SAM Datei als Ein oder Ausgabe datei f r das ber
463. n JOB PARAMETER Parameter f r ENTER Aufruf eines Jobs einer S Prozedur oder eines Server Stellvertreters JOB STATUS Zustandsindikator eines Jobs einer S Prozedur oder eines Server Jobs Job Steuersatz Bestandteil der Netzbeschreibung beschreibt die Position eines Jobs oder einer S Prozedur innerhalb des Netzes sowie seine Parameter JOB TEXT Kurzbeschreibung des Jobs der S Prozedur oder des Server Jobs JOB TYPE Indikator f r die Verwaltung der JCL eines Auftrags Job S Prozedur Server Job im AVAS System und die Kontrolle des Auftrags ber eine Jobvari able STD MOD EXT EXX Journaldatei Ausgabemedium f r die Protokollierung der Aktionen der Benutzer am AVAS System und der Aktivit ten der Ablaufsteuerung JRLDAT Linkname f r die Not Journaldatei JRNDAT Linkname f r die Journaldatei JVA LENGTH L nge des Wertes einer Jobvariablen JVA NAME Name einer Jobvariablen JVA PASSWORD Kennwort f r eine Jobvariable JVA POSITION Anfangsposition des Wertes in der Jobvariablen 532 U21462 J Z125 7 Fachw rter Kalender Von Anfangs und Enddatum begrenzte Tagesleiste Jedem Tag ist ein Wochen tag zugeordnet Jedem Tag k nnen ein oder mehrere symbolische Starttermine zugeordnet werden Jedem Benutzerkreis ist ein Standardkalender zugeord net Netze k nnen auch einem bestimmten Kalender zugeordnet sein Kalender werden unter eindeutigen Namen in der Bibliothek CALLIB abgelegt und ver waltet
464. n STARTING2 SV JVs werden eingerichtet bzw gel scht STARTING3 Server Status werden ermittelt READY SV JVs sind aktualisiert RUNNING Die Konfigurationsdatei wird neu eingelesen und oder die Server Status werden erneut ermittelt ENDING SV JVs werden zur ckgesetzt d h sie erhalten den Wert U ENDED AVAS Prozess Server berwachung wird beendet W hrend der Startphase STARTING 1 3 der Aktualisierung RUNNING und nach SHUTDOWN werden Anderungen f r die kontrollierende Jobvariable nicht bearbeitet Aktion zur kurzfristigen Sperre eines Servers F r einen Server kann z B bei eventuellen Konfigurationsarbeiten kurzfristig die Jobver teilung durch die Ablaufsteuerung ausgeschaltet werden Hierzu wird die entsprechende Server Jobvariable auf I Ignore gesetzt Soll die Sperre wieder aufgehoben werden ist wieder der Wert R Running zu setzen 132 U21462 J Z125 7 Administration von AVAS Bedienen und berwachen der AVAS Prozesse 3 2 4 berwachen der Prozesse ber Jobvariablen Zum berwachen einiger Batch Prozesse des AVAS Systems dienen die den Prozessen zugeordneten Jobvariablen siehe Abschnitt Definitionen f r die zentralen Zugriffsprozes se auf Seite 22 ber diese Jobvariablen k nnen Anweisungen f r die Prozesse ab Stelle 1 eingegeben der Status der Prozesse abgefragt und das ordnungsgem e Ende der Prozesse eingeleitet werden Status der Prozesse Eingabe SHOW JV JV IDENTIFICATI
465. n pfe Weiter und Abbrechen ist im Dialog fenster beschrieben Der Folgedialog bietet das Lesen der Readme Datei mit Informationen zu Produktinstalla tion und Produktstart sowie zu neuen Funktionen in der aktuellen Version Die Aktionskn pfe Zur ck Weiter und Abbrechen stehen zur Verf gung Dr cken Sie Weiter um im n chsten Dialog den Zielordner Ihrer Installation zu bestim men Als Standard Installationspfad wird der Produktpfad vorgeschlagen der durch die Windows Konventionen festgelegt ist lt SystemLaufwerk gt lt ProgramFilesDir gt aus Registry lt Produkt gt lt Produktname gt C Programme Siemens AVAS NT Die Nutzung der Aktionskn pfe ist im Dialog beschrieben Mit lt Weiter gt gelangen Sie in den Produktauswahl Dialog Es werden die auf der CD ver f gbaren Produktversionen zur Auswahl angeboten Wenn beim Verlassen des Dialogs nur AVAS R3JobControl ausgew hlt ist und der Server AVAS SV nicht auf dem Rechner installiert ist wird dieser Server automatisch installiert da AVAS R3JobControl ohne Server keine g ltige Installation ist Der Server AVAS SV l uft als Windows Dienst mit der Bezeichnung AvasService Im Folge dialog werden die Standardwerte f r die Startparameter dieses Windows Dienstes vorge geben sie k nnen hier vom Anwender ge ndert werden Beim Verlassen des Dialogs mit lt Weiter gt werden die aktuellen Bildschirmwerte in der Registrierdatenbank gespeichert Diese wir
466. n AVAS WORKDIR UNIX Systeme oder in der Registry unter WorkDir Windows Systeme hinterlegt Bei UNIX und Windows Systemen muss pfad deshalb nicht an gegeben werden ist aber aus Kompatibilit tsgr nden weiterhin zu gelassen und wird ignoriert Die einzelnen Bereiche m ssen durch mindestens ein Leerzeichen getrennt werden Die Angabe lt server name gt muss an Stelle 1 die Angabe lt server pw gt an Stelle 10 beginnen Kein Eintrag darf Leerzeichen enthalten da sie als Trennzeichen interpretiert w rden Das lt comm pw gt wird zum Server Rechner bertragen und dabei von EBCDIC nach ASCII bersetzt Es darf daher nur Zeichen enthalten die in der verwendeten Ubersetzungstabel le definiert sind Standardm ig wird verwendet Code Umsetzung EBCDIC ASCII Die Bereiche lt dir gt und lt pfad gt k nnen aus AVAS Sicht Zeichenfolgen beliebiger L nge enthalten Beschr nkungen ergeben sich nur da Pfadnamen im Server System begrenzt sind In der Lange sind auch der Name des Home Directory und der Dateiname enthalten Die Datei muss als ISAM Datei erstellt werden mit KEY LENGTH 9 KEY POS 5 und RECORD FORMAT VARIABLE Als ISAM Schl ssel wird der server name 8 Byte gefolgt von einem Leerzeichen verwendet Wegen dir und lt pfad gt kann es vorkommen dass ein Eintrag die zul ssige Maximall nge berschreitet die der EDT bearbeiten kann F r diesen Fall k nnen Folgezeilen angegeben werden Als ISAM Schl ssel f r
467. n Journals tze ausgegeben wird bzw ein Journalsatz mehrfach f r unterschiedliche Objekte z B Jobs ausgegeben werden kann Hinweise e Die Ausgabe der mit x gekennzeichneten Journals tze kann im RZ Exit 1 bzw AVEX0002 unterdr ckt werden e Der Umfang der Protokollierung bei der Anweisung CREATE PROD NET kann ber den Generierungs Parameter PARAM JOURNAL OUTPUT gesteuert werden e Abhangig vom Generierungs Parameter werden folgende Journals tze ausgegeben PARAM JOURNAL Journalausgabe mit Journalsatz STD 25 01 nein 25 02 LIST nein 21 01 ALL 25 01 21 01 25 02 NO nein nein Der Anwender kann ber RZ Exit AVEX0001 bzw AVEX0002 pr fen ob Parameter aus den Netz oder Jobmasken oder aus der USER PARAM FILE modifiziert werden und die Proto kollierung aus der USER PARAM FILE unterdr cken U21462 J Z125 7 191 Sicherung und Reorganisation U21462 J Z125 7 Ausgabe im Datenbereich S11 AVASJRN S12 AVASJRN x S12 AVASJRN x S11 AVASJRN S11 AVASJRN MSG7 Text S14 AVASJRN S14 AVASJRN S14 AVASJRN MSG7 Text S16 AVASJRN S16 AVASJRN MSG7 Text S15 AVASJRN S15 AVASJRN MSG7 Text Datenstrukturen Journalsicherung Not Journaldatei SSL FNR Anweisung CREATE ORDER Start der Funktion Ende der Funktion Abbruch der Funktion CREATE PLAN NET Start der Planung Ausgabe Strukturelement L schen Strukturelement Ende der Planung Abbruch der Planung Fehlermeldung
468. n Parameter NET STATUS 375 U21462 J Z125 7 READ AVAS LIBRARY Programmschnittstelle von AVAS READ AVAS LIBRARY Lesezugriff auf Journaldatei und Ablaufdatei Die Anweisung erm glicht Benutzerprogrammen den Lesezugriff auf die AVAS Journal datei und die AVAS Ablaufdatei Das Programm kann folgende Informationen anfordern Aus der Journaldatei e Inhaltsverzeichnis der Netze einer Netzgruppe READ AVAS LIBRARY AVAS USER LIBRARY JRNDAT AVSCUSLB NET NAME group AVSCNETN RUN CONTROL SYSTEM avak AVSCRCSN PERIOD NAME period AVSCPERN e Alle Journale eines Netzes READ AVAS LIBRARY AVAS USER LIBRARY JRNDAT AVSCUSLB NET NAME netname AVSCNETN RUN CONTROL SYSTEM avak AVSCRCSN Aus der Ablaufdatei zu Netzen e Inhaltsverzeichnis der Netze einer Netzgruppe READ AVAS LIBRARY AVAS USER LIBRARY ABLDAT AVSCUSLB NET NAME group AVSCNETN RUN CONTROL SYSTEM avak AVSCRCSN NET STATUS status AVSCNST1 PERIOD NAME period AVSCPERN 376 U21462 J Z125 7 Programmschnittstelle von AVAS READ AVAS LIBRARY e Strukturdaten eines Netzes READ AVAS LIBRARY AVAS USER LIBRARY ABLDAT AVSCUSLB NET NAME netname AVSCNETN RUN CONTROL SYSTEM avak AVSCRCSN NET STATUS status AVSCNST1 Aus der Ablaufdatei zu Ereignissen e bersicht ber Bedingungseintr ge e Daten eines Bedingungseintrags READ AVAS LIBRARY AVAS USER LIBRARY ABLDAT AVSCUSLB CONDITION NAMES condname group AVSCCDNM CONDITION TYPE t
469. n Startparametern des AVAS Servers gefragt Auch hier werden f r Portnummer Kommunikationskennwort Arbeitsverzeichnis und Protokolldatei Standardwerte vorgegeben die mit der ENTER Taste bernommen oder durch eine neue Eingabe ge ndert werden k nnen Die Eingabewerte werden im AVAS SV Installationsverzeichnis in der Datei Serup avs gespeichert sie k nnen dort auch nachtr glich ge ndert werden Die g ltigen Installations Parameter werden in einer bersicht am Bildschirm angezeigt und m ssen vom Anwender best tigt werden Erst danach werden die Produktdateien in das entsprechende Installationsverzeichnis kopiert Mit q uit kann der Dialog verlassen werden Das Produkt wird in diesem Fall nicht installiert U21462 J Z125 7 447 Installation von AVAS SV AVAS SV Plattform bergreifende Jobsteuerung Installation von AVAS SV und von AVAS R3JobControl auf Windows Systemen Die Installation erfolgt durch den automatischen Aufruf autorun inf eines Setup Programms nachdem die CD in das CDROM Laufwerk eingelegt wurde Das Setup Programm wurde nach den aktuellen Konventionen f r 32 Bit Anwendungen unter Windows entwickelt Im Startbildschirm wird die Installationssprache zur Auswahl angeboten F r den AVAS Server auf Windows Systemen kann Deutsch oder U S English eingestellt werden Es folgt der Begr Bungsschirm mit Hinweisen zur rechtlichen Nutzung der zu installieren den Software Die Bedeutung der Aktionsk
470. n die Ausgabe des Satzes nicht unterdr ckt werden darf Hinweis Wenn die RZ Routine andere Returncodes zur ckmeldet setzt AVAS eine Meldung ab und der Journalsatz wird in die Journaldatei ausgegeben RZ Exit AVEX0101 Nachdem eine Netzbeschreibung in die NETLIB zur ck geschrieben wurde ruft AVAS die RZ Routine auf Der Parameter Versionsummer hat immer den Wert C 001 der LMS Typ ist immer C S pfixLIB DS CL6 Ausgabe Parameter Keyword Bibliothek NETxxx DS CL2 wird nicht verwendet pfixLNAM DS CL54 Ausgabe Parameter Bibliotheksname DS CL2 wird nicht verwendet pfixNNAM DS CL32 Ausgabe Parameter Netzname DS CL28 wird nicht verwendet pfixVERS DS CL3 Ausgabe Parameter Versionsnummer 001 pfixLTYP DS CL1 Ausgabe Parameter LMS Typ S DS CL4 wird nicht verwendet pfixDATE DS CL8 Aktuelles Datum yymmdd pfixTIME DS CL6 Aktuelle Uhrzeit hhmmss pfixCMDN DS CL22 Kommandoname U21462 J Z125 7 2 4 6 82 Installation und Generierung RZ Exits im AVAS System R ckgabe der RZ Routine an AVAS Eine evtl R ckgabe der RZ Routine an AVAS im Feld pfixRCS des Verst ndigungsberei ches wird nicht ausgewertet 2 4 7 RZ Exit AVEX0102 Bevor eine Jobbeschreibung in die JCLLIB bzw JMDLIB zur ck geschrieben wird ruft AVAS die RZ Routine auf Der Parameter Versionsummer hat immer den Wert C 001 der LMS Typ ist immer C J pfixLIB DS CL6 Ausgabe Parameter Keyword Bibliothek JCLxxx JMDxxx DS CL2 wird nicht verwendet pf
471. n die von AVAS ben tigten Pubsets Home Pubset Shared Public Volume Set erreichbar sein Der Beginn der Wartezeit wird durch die Meldung AVS8301 ange zeigt das Ende durch die Meldung AVS8500 Beispiel AVS8301 EINGABE R in MSCF CONTROL JVA VPASS 00000300 AVS8500 EINGABE R in MSCF CONTROL JVA VPASS 00000300 VERARBEITET control time routing code und mscf control time k nnen im laufenden AVAS Betrieb ge n dert werden Sie werden beim n chsten Start der Ablaufsteuerung wirksam AVAK avak control time routing code jvavak mscf control time Definition weiterer Ablaufsteuerungen U21462 J Z125 7 36 Installation und Generierung Generierung des AVAS Systems 2 2 2 5 Definieren der Standardwerte f r Verarbeitungs Parameter F r systemweit festgelegte Standardwerte k nnen Standardwerte ber die Generierungs Parameter vorgegeben oder konfigurationsspezifische Einstellungen getroffen werden Einige Standardwerte werden in den verschiedenen Operationen als Parameter angenom men wenn in den betroffenen Maskenfeldern keine Eingabe erfolgt Andere Standardwerte steuern das Verhalten von Operationen bei der Verarbeitung F r die Eingabe von Operationen k nnen Funktionstasten an den Datensichtger ten ver wendet werden Definition der Funktionstasten f r die Operationseingabe Die K und F Tasten eines Datensichtger tes k nnen zur Eingabe von Operationen belegt werden Nicht belegte Tasten f hren
472. n k nnen Definition von Standardwerten f r die Jobbearbeitung Wenn ein Standardwert nicht beschrieben wird wird der unterstrichene Wert angenom men DEFAULT OVERWRITE JOB YES NO Standardwert f r den Parameter OVERWRITE in der Maske AVEO11 der Operation EDIT JOB DEFAULT OVERWRITE PRODJOBS YES NO Standardwert f r den Parameter OVERWRITE in der Maske AVEO11 der Operation EDIT PROD JOB DEFAULT PROCPAR STRING AVAS PROC PAR c string 1 16 lt Wert f r das Trennzeichen bei S Prozeduren U21462 J Z125 7 40 Installation und Generierung Generierung des AVAS Systems Das Trennzeichen wird bei S Prozeduren dazu verwendet den Prozedurbereich von der Parameterbeschreibung zu trennen Die Zeichenfolge wird bei S Prozeduren in der JCLLIB JCLSYS JMDLIB JMDSYS und ABLDAT generell als letzter Satz abgelegt auch wenn ohne Parameter gearbeitet wird Hinweis Die Zeichenfolge muss auch bei COPY ELEMENT mit MODE LIBIN SAMIN und AVAS USER LIBRARY JCLLIB beim Kopieren von S Prozeduren verwendet werden Sonst werden die kopierten Elemente als Jobs im Inhaltsverzeichnis der JCLLIB eingetragen Die Zeichenfolge ist f r AVAS reserviert und darf in den S Prozeduren nicht in einem anderen Zusammenhang verwendet werden Die Zeichenfolge darf nicht mit dem Wert von DEFAULT SERVERPAR STRING identisch sein DEFAULT SERVERPAR STRING AVS SINIX PAR c string 1 16 lt Wert f r das Trennzeichen bei Server
473. n k nnen nachfolgend mit TRANSFER in die LOGSYS bertragen werden Wird keine Datei mit dem Namen gefunden erzeugt SIGNAL einen Eintrag mit dem Namen AVSSVLOG lt job id gt lt tsn gt STDOUT da mit der Benutzer diese Datei nachfolgend mit TRANSFER in die LOGSYS bertragen kann Auf dem Server k nnen STDOUT und STDERR beliebige Dateien zugeordnet werden siehe Abschnitt AVSLOG Zuordnung der Protokolldateinamen auf Seite 493 Hinweis Vom Server Job k nnen maximal zwei Dateien signalisiert und ber TRANSFER eingesammelt werden Bei Verbindungsverlust oder Abbruch von AVSSINCM k nnen die Dateien ber ADD JOB LOG nachgetragen werden Wurden die Protokolle noch nicht vom Server zum BS2000 OSD bertragen muss dies durch den Anwender vor der Ausf hrung von ADD JOB LOG mit geeigneten Programmen z B ftp erfolgen U21462 J Z125 7 145 Administrationsaufgaben im Betrieb Administration von AVAS dateiname Gibt den Namen der Protokolldatei an die an CENTRAL gesendet werden soll Die Ubertragung einer beliebigen SAM oder ISAM Datei ohne Indexschl ssel ist dadurch m glich Hinweis Der Parameter ist nur erforderlich wenn eine andere Protokolldatei als die mit ASSIGN SYSOUT zugewiesene Datei gesammelt wer den soll TRANSFER OPTION ENDED ERROR NO ENDED Die Ablaufsteuerung startet zur bertragung dieses Protokolls einen Folgejob wenn im Job kein Aufruf TRANSFER enthalten ist Die fehlerfreie be
474. n oder eine Fehlermeldung U21462 J Z125 7 327 CREATE PROD NET BATCH Anweisungen CREATE PROD NET Erstellen tempor rer BS2000 Jobs S Prozeduren und Server Jobs eines Netzes Die BATCH Anweisung CREATE PROD NET kann nur verwendet werden wenn in den BS2000 Jobs S Prozeduren und Server Jobs des Netzes keine Masken ber die AVAS Anweisung AVM zugeordnet werden Die Netzparameter m ssen vorher ber die Anweisung COLLECT NET PARAMS einge geben werden Empfohlen wird die BATCH Anweisung vorzugsweise bei der Modifikation ber USER PARAM FILE zu verwenden CREATE PROD NET NET NAME S bk netname PERIOD NAME period USER PAR FILE NONE dateiname libname element typ Der Parameter PERIOD NAME ist nur in Verbindung mit einem teilqualifizierten Netzna men zugelassen Bei teilqualifiziertem Netznamen entspricht der Parameter USER PAR FILE dem Wert im Parameterfeld USER PAR FILE NONE der Maske AVMO12 mit der Netzliste Bei vollqualifiziertem Netznamen entspricht der Parameter USER PAR FILE dem Wert im Parameterfeld USER PAR FILE der Maske AVMOO 1 mit der Beschreibung der Daten eines Strukturelements Wenn die mit USER PARAM FILE angegebene Datei in der BATCH Verarbeitung nicht vor handen ist wird wie im Dialog eine Meldung ausgegeben Die Verarbeitung wird jedoch fortgesetzt und f hrt erst bei fehlenden Parametern zur Meldung und zum Abbruch Weiterhin gelten die bei der Dialogfunktion beschriebenen Regeln
475. n von FHS DOORS Eine Beispielsitzung f hrt exemplarisch an das Arbeiten mit FHS DOORS heran Beschrieben sind zudem die Parameter mit denen Sitzungen anwendungsgerecht konfiguriert werden k nnen und die Schnittstellen zu einer eigenen Bibliothek zur Formaterkennung und zu OLE Automation Weiter enth lt das Handbuch die Beschreibung des Formatkonverters FHS DOORS LC und des Event Stream Service ESS DOORS Bestellnummer U22049 J Z125 3 U21462 J Z125 7 541 Literatur 9 BS2000 OSD BC V6 0 Kommandos Band 1 5 Benutzerhandbuch Zielgruppe Das Handbuch wendet sich sowohl an den nichtprivilegierten Anwender als auch an die Systembetreuung Inhalt Die B nde 1 5 enthalten die Kommandos ADD bis WRITE BS2000 OSD Grund ausbau und ausgew hlte Produkte mit der Funktionalit t f r alle Privilegien Die Kom mando und Operandenfunktionen werden ausf hrlich beschrieben viele Beispiele unter st tzen das Verst ndnis Am Anfang jedes Bandes informiert eine bersicht ber alle in den B nden 1 5 beschriebenen Kommandos Der Anhang von Band 1 enth lt u a Informationen zur Kommandoeingabe zu bedingten Jobvariablenausdr cken Systemdateien Auftragsschaltern Ger te und Volumetypen Der Anhang der B nde 4 und 5 enth lt jeweils eine bersicht zu den Ausgabespalten der SHOW Kommandos der Komponente NDM Der Anhang von Band 5 enth lt zus tzlich eine bersicht aller START Kommandos In jedem Band ist ein umfang
476. nals tzen sind jedoch auch dann nicht zu vermeiden e Hohe Systembelastungen und Laufzeiten entstehen wenn mehrere BATCH L ufe auf die gleichen Elemente zugreifen wollen Um dies zu vermeiden ist Folgendes zu beachten Bei der Planung ber den Kalender CREATE PLAN NET mit PERIOD NAME m ssen immer alle Netze eines Benutzerkreises gelesen und nach symbolischen Startterminen durchsucht werden wenn kein teilqualifizierter Netzname vorge geben wird Wenn bei CREATE PLAN NET ein Netz nicht gelesen werden kann weil es gesperrt ist k nnen auch die Starttermine des Netzes nicht ausgewertet werden Ob f r das Netz Ablaufvarianten geplant werden sollen oder nicht ist offen kein RESULT NO PLAN Wenn CREATE PLAN NET ber BATCH abgewickelt wird sollte immer ein hinrei chend teilqualifizierter Netzname angegeben werden e Ebenfalls hohe Systembelastungen und Laufzeiten entstehen wenn die Reorganisa tion zusammen mit AVAS BATCH Abl ufen gestartet wird Bei der Reorganisation sind die Netzverzeichnisse der Ablaufdatei oder der Journaldatei gesperrt wenn Netze in den Dateien gel scht werden Die Dateien sind gesperrt wenn die freigewordenen Bl cke in die Kette der freien Bl cke eingekettet werden U21462 J Z125 7 161 Administrationsaufgaben im Betrieb Administration von AVAS 162 U21462 J Z125 7 4 Sicherung und Reorganisation In diesem Kapitel sind die Sicherung und die Reorganisation von Dateien
477. nd der Kennung userid zugeordnet sind Dieser Parameter ist zu w hlen falls derselbe Dateiname im MAREN Katalog unter mehreren Kennungen vorkommt und es sich hierbei um verschiedene Dateien handelt Wenn MARENAV unter der angegebenen Kennung keine Archiveintr ge mit diesem Dateinamen findet wird die Produktionsfreigabe abgebrochen OWN ALL userid Die mit REMARK UID getroffene Auswahl an VSNs gilt nur bis Jobende Innerhalb eines Jobs k nnen beliebig weitere REMARK UID Kommandos verwendet werden Die Auswahl ist solange g ltig bis durch das folgende Kommando REMARK UID eine neue Auswahl getroffen wird U21462 J Z125 7 264 Kopplung AVAS mit MAREN Eintragen von VSNs in die JCL 6 2 2 Eintragen von VSNs bei Ausgabeb ndern Beim Kommando CREATE FILE FILE NAME file SUPPORT TAPE VOLUME SCR DEVICE TYPE device reserviert MARENAV ein freies Band und tr gt die erhaltene VSN an Stelle des Platzhalters SCR in das betreffende DVS Kommando ein Die Benutzerkennung f r die das Band reserviert wird wird auf dieselbe Art festgelegt wie sie bei Eingabeb ndern mit REMARK UID OWN eingestellt werden kann D h wenn der im Kommando ange gebene Dateiname keine Kennung enth lt wird eine Reservierung f r die Ablaufkennung vorgenommen Diese wird wie folgt ermittelt e Wenn im AVAS Kommunikationsbereich das Feld nameJENT mit dem Wert nameJENTJ versorgt ist dann ist im Feld nameJUSE die Ablaufkennung hi
478. nd neue Werte sind gepr ft starten J Y weiter in Prozedur N Abbruch kein UPDATE amp UPDATE Funktion J Y weiter in Prozedur N Abbruch kein UPDATE Hinweise Mit alt bzw OLD sind die Werte bezeichnet die in der Ablaufdatei und der Journaldatei der alten Version eingetragen sind Mit neu bzw NEW sind die Werte bezeichnet die in den System Parametern der neuen Version eingetragen sind U21462 J Z125 7 59 Versionswechsel mit ABLDAT und JRNDAT Installation und Generierung Ablauf der Prozedur 1 Der Anwender wird gefragt ob er eine Sicherungskopie der Ablaufdatei und der Jour naldatei erstellt hat Antwort JA Weiter in Prozedur NEIN Abbruch der Prozedur 2 Der Anwender wird gefragt ob er die System Parameter f r die neue Version von AVAS generiert hat Antwort JA Weiter in Prozedur NEIN Abbruch der Prozedur 3 Der Anwender wird aufgefordert den Namen der neuen System Parameterdatei SYSPAR und die Namen der neuen Ablaufdatei ABLDAT und der neuen Journaldatei JRNDAT vorzugeben 4 Der Anwender wird aufgefordert den Namen der alten AVAS SYSTEM ID OLDSYSID und den Namen der neuen AVAS SYSTEM ID NEWSYSID vorzugeben 5 Der Anwender wird aufgefordert den Namen einer LIST Datei ein Pr fix f r Jobvariab le und die USER ID anzugeben unter der das Programm DPAGE gefunden wird 6 Die vorgegebene neue System Parameterdatei SYSPAR wird mit EDT ein
479. nden Journalsicherung werden die Journals tze der Netze in die Siche rungsdatei ausgegeben 4 Beider folgenden Reorganisation werden die Netze in der Journaldatei gel scht Wenn die Netze direkt nach der Sicherung in der Journaldatei gel scht werden sollen kann das Reorganisationsprogramm nach der Sicherung ein zweites Mal gestartet werden wobei nur die Funktion FUNKTION JRNDAT anzugeben ist 4 1 1 Reorganisation der Ablaufdatei und der Journaldatei Die Reorganisation kann im laufenden Betrieb erfolgen Das Programm greift ber den Zugriffsprozess f r Ablaufdatei und Journaldatei auf die Ablaufdatei und die Journaldatei Zu Zus tzlich wird eine Sicherungsdatei f r die Journale erstellt die aus der Journaldatei entfernt werden Diese Sicherungsdatei wird in der Benutzerkennung eingerichtet in der das Reorganisationsprogramm l uft Zum Ablauf der Reorganisation muss der zentrale Zugriffsprozess UPAM ZD vorhanden sein und wenn die Reorganisationsanweisung DELETE PLAN NET YES angegeben wird auch der Zugriffsprozess PLAM ZD Bei der Reorganisation laufen folgende Vorg nge ab 1 Aus der Journaldatei werden alle Netze entfernt deren Journale bereits in eine Siche rungsdatei geschrieben worden sind Dies ist am Netzstatus DELETED SAVED zu erkennen Reorganisationsanweisung FUNKTION JRNDAT 2 Aus der Journaldatei werden die Journale aller Netze gesichert deren Status DELETED ist Gleichzeitig wird ihr Netzstatus auf DELETED
480. nfigurationsdatei wurde in Bezug auf Servereintr ge ge ndert Die Server berwachung liest die Konfigurationsdatei und aktualisiert die zu berwachende Serverumgebung CONFIGn n 1 1440 Wirkung wie CONFIG Zus tzlich wird der Wert f r CONFIG CONTROL TIME mit n versorgt Die nderung wird nach SYSOUT protokolliert SERVER Die Server werden neu berpr ft Die Konfigurationsdatei wird jedoch nicht neu eingelesen SERVERn n 1 100 Wirkung wie SERVER Zus tzlich wird der Wert f r SV CONTROL TIME mit n versorgt Die nderung wird nach SYSOUT protokolliert Aktion zur kurzfristigen Sperre eines Servers F r einen Server kann z B bei eventuellen Konfigurationsarbeiten kurzfristig die Jobver teilung durch die Ablaufsteuerung ausgeschaltet werden Hierzu wird die entsprechende Server Jobvariable auf l IGNORE gesetzt Soll die Sperre wieder aufgehoben werden ist wieder der Wert R zu setzen U21462 J Z125 7 491 Programme des AVAS Servers AVAS SV Plattform bergreifende Jobsteuerung 11 4 Programme des AVAS Servers auf Windows und UNIX Systemen Mit dem AVAS Server werden folgende Programme angeboten AVSSINJV Modifizieren der Auftrags Jobvariable Mit dem Programm AVSSINJV kann der Benutzer des Server Systems vom Server Job aus Hinweise oder Statusmeldungen in die Auftrags Jobvariable schreiben wenn der Server Job ber den AVAS Server gestartet wurde AVSSINJV wird im Server Skript wie fo
481. nfolge aufgef hrt d h So wie sie zum Ablaufzeitpunkt von den einzelnen Jobs eines Netzes angefordert werden Beispiel f r den Aufbau einer Bandmontierliste Die Bandmontierliste hat den Dateinamen OPR AVAS RCS003 001218 113012 Sie wird unter der Kennung des Benutzers abgelegt der die Netze zur Produktion freigibt Diese Datei ist unter den gleichen Gegebenheiten wie im Beispiel Transportliste fol genderma en aufgebaut FILE OPR AVAS RCS003 001218 113012 PAGE 1 DATE TIME OF RELEASE 02 12 18 11 30 NET NAME BKO1 GEH NET 001219 160500 EARLIEST START 02 12 19 16 05 INDEX JOBNAME CATID FROM LOC TO LOC VOLUME REMARK 010 GEHALTOl CIO2 CENTRAL DA127E02 Y1B001 010 GEHALTOl CIO2 DVA1l DA12ZE02 Y1C002 010 GEHALTOl CIO2 DVA11 DA12ZE02 Y1D001 020 GEHALTO2 C3 CENTRAL CPUOO03 Y1A003 VOLUME IS EXPORTED 020 GEHALTO2 C3 CPU003 REQUESTED FOR 2 PRIVATE TAPES 020 GEHALTO2 C3 CPU003 WITH DEVICE TYPE T6250 020 GEHALTO2 C3 DVA12 1080003 3 020 GEHALTO2 C3 DVAll 080003 2 U21462 J Z125 7 271 Erstellen von Datentr gerlisten Kopplung AVAS mit MAREN 6 3 3 Verlagerungsprozedur Diese Datei hat den Namen PRC AVAS rcs yymmdd hhmmss rcs Name des Ablaufsteuerungssystems yymmdd hhmmss Datum und Uhrzeit der Produktionsfreigabe F r alle von einem Netz ben tigten Datentr ger werden in dieser Prozedurdatei die Lager
482. ng Ablauf 110 159 Serialisierungsbegriff an UPAM ZD 159 Server Ausfall 516 deinstallieren 450 kurzfristige Sperre 132 zyklische berpr fung 123 Server Job 473 abbrechen 517 kontrollieren Vorbereitungen 518 starten Vorbereitungen 518 statischer 537 Status 457 tempor rer 537 Zusatzstatus 457 Server JV Datei 469 SERVER JV LINK 119 Server Konfigurationsdatei 120 518 erstellen 459 SERVER NAME 537 556 Stichw rter CENTRAL Prozess 141 Programm aus Server Job 484 Prozesse 107 Server Job 518 SIGNAL Programm 144 TRANSFER Programm 148 zentrale Zugriffsprozesse 107 Startparameter Ablaufsteuerung CONFIG FILE NAME 120 CONFIG FILE PASSWORD 120 GENERATE JOB LOG 118 SERVER PROCEDURE NAME 119 SERVER PROCEDURE PASSWORD 120 Steuerung der Protokollverarbeitung 118 TRANSFER PROCEDURE NAME 118 TRANSFER PROCEDURE PASSWORD 119 Zusammenarbeit mit Server Rechnern 119 Startparameter f r AVSSINCM 465 AVS AVAK FILE 465 AVS AVAK FILE PASSWORD 466 AVS AVAK NAME 465 AVS AVAS VERSION 466 AVS CONF FILE 5 AVS CONF PASSW 465 AVS JOB CLASS 6 AVS JOB ID 465 AVS JOB INDEX 5 AVS JOB LOG 6 AVS JOB NAME 465 AVS JOB PARAMETER 466 AVS JOB TYPE 465 AVS MONJV PASSW 465 AVS NET NAME 465 AVS PARTNER PASSW 466 AVS SERVER NAME 466 AVS SERVER VERSION 466 AVS SVDOG JV 467 AVS SV PARAM 466 AVS SYSTEM ID 466 AVS USER ACCOUNT 466 AVS USER ID 466 AVS USER PASSW 466 CNTAPC 5 557 Standard Periode 320 l schen 331 mit
483. ng und die Namen der Ablauf steuerungen ge ndert werden Diese Anderung erfolgt ber eine Korrektur mit dem BS2000 Dienstprogramm DPAGE Folgende Schritte sind f r die bernahme erforderlich e System der alten Version normal beenden Dies gilt auch f r die eingetragenen Ablaufsteuerungen entsprechend den Eintr gen in der Ablaufdatei e Dateien der alten Version mit neuem Namen sichern e System Parameter der neuen Version generieren e Prozedur AVS UPDATE VERSION starten Dabei muss die erste Ablaufsteuerung in der Reihenfolge beschreiben werden wie sie in der SYSPAR Datei und der ABLDAT Datei eingetragen ist Folgende Parameter sind f r den Ablauf erforderlich amp ABLDAT Name der Ablaufdatei ABLDAT amp JRNDAT Name der Journaldatei JRNDAT amp SYSP Name der neuen System Parameterdatei SYSPAR amp OLDSYSID Name der alten Systemkennung SYSTEM ID amp NEWSYSID Name der neuen Systemkennung SYSTEM ID amp OLDRCS1 Alter Name der 1 Ablaufsteuerung R C S amp NEWRCS1 Neuer Name der 1 Ablaufsteuerung R C S amp LISTE Name der Datei f r das Protokoll der nderungen amp JVNAM Pr fix f r Jobvariable 58 U21462 J Z125 7 Installation und Generierung Versionswechsel mit ABLDAT und JRNDAT amp SAVE Dateien ABLDAT und JRNDAT gesichert J Y weiter in Prozedur N Abbruch kein UPDATE amp GEN System Parameter SYSPAR generiert J Y weiter in Prozedur N Abbruch kein UPDATE amp START Alte u
484. ng zur Bearbeitung bevor sie in die Ablauf datei eingetragen wird Dar ber hinaus wird die RZ Routine aufgerufen wenn alle Auf tr ge eines Netzes bearbeitet worden sind 2 4 4 Einbinden der RZ Routinen in AVAS Die RZ Routinen m ssen zusammen mit einem AVAS Systemmodul und einem AVAS Schnittstellenmodul zu einem gemeinsamen AVAS EXIT Modul AVO3EXIT AVO4EXIT oder AVOGEXIT gebunden werden Diese Module werden beim Laden des AVAS Systems in der Modulbibliothek gesucht die mit dem LINK Namen SYSLNK oder mit TASKLIB zugewiesen wurde Zum Erstellen des EXIT Moduls sind folgende Binderanweisungen in der angegebenen Reihenfolge anzugeben MODULE AVOGEXIT INCLUDE AVO3EXL Cavas systembibliothek INCLUDE AVO3EXT Cavas systembibliothek INCLUDE rz routinen Die gleiche Reihenfolge gilt f r den EXIT Modul AVO4EXIT bzw AVOGEXIT MODULE AVOAEXIT INCLUDE AVOAEXL Cavas systembibliothek INCLUDE AVOAEXT Cavas systembibliothek INCLUDE rz routinen MODULE AVO6GEXIT INCLUDE AVOGEXL Cavas systembibliothek INCLUDE AVOGEXT Cavas systembibliothek INCLUDE rz routinen Beispiel MODULE AVO3EXIT INCLUDE AVOG3EXL Cavas systembibliothek INCLUDE AVO3EXT avas systembibliothek INCLUDE AVEX7102 benutzer modulbibliothek INCLUDE AVEX7101 benutzer modulbibliothek USW Es muss nicht f r jeden m glichen RZ Exit eine RZ Routine angegeben werden Als AVAS Systembibliothek muss die Bibliothek S
485. ngaben die Anfangs und Enddatum Zeit der Periode FROM DATE TO DATE bestimmen Wenn nur das Enddatum TO DATE definiert werden soll muss davor ein Komma ange geben werden Wenn das Enddatum TO DATE nicht angegeben wird wird das Enddatum auf Anfangs datum und die Endzeit auf 23 59 59 gesetzt Die Menge der auszuw hlenden Netze kann durch die Anweisung NET NAME weiter ein geschr nkt werden Wenn die Anweisung nicht angegeben wird werden die Netze ohne Ber cksichtigung der geplanten Startzeit PLAN START ausgew hlt Wenn die Anweisungen NET NAME und PERIOD NAME angegeben werden werden nur die Netze ausgew hlt die beide Auswahlkriterien erf llen REPORT NAME Ausw hlen von Reports Mit REPORT NAME wird ein Report ausgew hlt REPORT NAME OUT OF PLAN PLANNED NET MODIFICATION REPORT NAME OUT OF PLAN Ein Report der nicht planm ig gestarteten oder planm ig ablaufenden Netze soll erstellt werden REPORT NAME PLANNED NET MODIFICATION Ein Report der Netze an denen nach der Planung oder w hrend des Ablaufs Ver nderun gen ber AVAS Funktionen vorgenommen wurden soll erstellt werden 296 U21462 J Z125 7 REPORT Anweisungen SELECT STATUS SELECT STATUS Ausw hlen Netze gem ihrem Status Mit SELECT STATUS werden die Netze gem ihrem globalen Status ausgew hlt deren S tze in die Reportdatei ausgegeben werden sollen Netze mit anderen als den angegebenen Status Werten werden nicht in die Reportd
486. ngen Markierung S ENTER Taste wie S EXEC Wenn in AVAS Masken ein Element in der Markierungsspalte mit S ausgew hlt wurde muss die Operation EXECUTE nicht mehr eingegeben werden Es gen gt das Bet ti gen der ENTER DUE Taste EXECUTE wird aber weiterhin akzeptiert siehe Handbuch AVAS Anweisungen 1 Kommando CONTINUE in Maskenfolgen Bei einer Maskenfolge in Netzbeschreibungen muss die letzte Maske nicht mehr mit RETURN verlassen werden Mit CONTINUE zeigt AVAS wieder die erste Maske an Kommandos in AVS005 in alphabetischer Reihenfolge Die AVAS Kommandos werden in Funktionstabellen AVS005 in alphabetischer Rei henfolge angezeigt MODIFY SYSTEM PARAMS SHOW SYSTEM PARAMS Bei CANCEL NET den gestarteten Server Job beenden Bei CANCEL NET k nnen die gestarteten Server Jobs FUZX die bisher ohne AVAS Kontrolle weiterliefen im System abgebrochen werden siehe Handbuch AVAS Anwei sungen 1 AVAS SV f r BS2000 0SD Zusatzprodukt AVAS SV BS2 Jobs k nnen ber AVAS SV auch in entfernten BS2000 Systemen gestartet werden In den Parametern NET CAT bzw JOB CAT ist dazu mit der Angabe eines Servernamens das Zielsystem festzulegen Die Verbindungsdaten dorthin werden ber den Serverna men aus der AVAS Konfigurationsdatei gelesen siehe Abschnitt Starten des AVAS Servers unter BS2000 OSD auf Seite 485 NET CONTROL mit S auf FU S zum Subnetz Aus der Netzstruktur eines Hypernetzes wird bei Markierung eines Stru
487. ngsrecht von lt userid gt auf dem Server Es muss in Gro buchstaben angegeben werden und in Spalte 10 beginnen Das Kennwort lt server pw gt wird im Feld SERVER PASSWORD der Maske AVN009 eingegeben hostname portnr Host Name bzw die IP Adresse des Server Rechners und die Socket Portnummer unter der der gew nschte AVAS Server er reicht wird U21462 J Z125 7 459 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung userid Benutzerkennung unter der der Job im Server System gestartet werden soll F r einen BS2000 Server ist NONE einzutragen Die Benutzerken nung f r den Jobablauf ist in der Netzbeschreibung enthalten comm pw Kommunikationskennwort ber das der AVAS Agent AVSSINCM seine Kommunikationsberechtigung gegen ber dem Server AVSRECV nachweist d h es muss mit dem ebenfalls als lt comm pw gt bezeichneten Kennwort bereinstimmen mit dem der Server gestartet wird Dies das Agenten Kennwort ist nicht das Kennwort f r die oben genannte Benutzerkennung lt userid gt zum Start eines Server Jobs dir Directory Teil des Verzeichnisses in dem ein externer Server Job bei TYPE EXT abgelegt ist Die Angabe gilt relativ zum Home Directory der lt userid gt UNIX System oder zum SystemRoot Verzeichnis Windows System Der endg ltige Pfadname f r einen Server Job wird gebildet aus Home Directory dir Angabe im Feld FILENAME der Maske AVNOOS F r externe Server Jobs kann d
488. nterlegt e Wenn das Feld nameJENT den Wert nameJENTL enth lt entspricht die Ablaufken nung der im Kommando SET LOGON PARAMETERS angegebenen Kennung Wenn berall die Kennung fehlt bricht MARENAV die Produktionsfreigabe ab Standardm Big werden die freien Datentr ger aus dem Lagerort reserviert der mit dem MAREN Parameter DEFAULT HOME LOCATION vereinbart wurde MARENADM Anwei sung RESERVE FREE VOLUME HOME LOCATION STD Wenn eine Reservierung aus einem anderen Lagerort erfolgen soll ist dieser zuvor im betreffenden Job zu definieren REMARK LOC lagerort Zu beachten ist dass vor und nach dem Zeichen keine Leerzeichen angegeben werden d rfen Die mit REMARK AL OCH getroffene Definition gilt stets nur bis Jobende In jedem Job kann der Reservierungs Lagerort beliebig oft ge ndert werden Wenn innerhalb eines Jobs erneut eine Reservierung aus DEFAULT HOME LOCATION erfolgen soll wird dies mit der Anweisung REMARK LOC STD erreicht Bei einer Multivolume Datei k nnen auch mehrere B nder vorgesehen werden Zum Bei spiel reserviert MARENAV bei Angabe von VOLUME SCR 3 drei B nder und ersetzt den Platzhalter durch eine VSN Liste vsn1 vsn2 vsn3 Auf diese Weise k nnen maximal 255 Datentr ger auf einmal reserviert werden Als Freigabedatum wird das Datum genommen aus der Addition von Srartzeit angegeben in EARLIEST STAHT plus Standard Sperrfrist eingestellt im MAREN Parameter DEFAULT FREE DATE In Anl
489. ntpoint gt f r device z B dev disk cdrom0a f r lt mountpoint gt z B cdrom e SuSE LINUX 7 0 auf Intel Plattform Mounten Sie die CD mit dem Kommando mount lt device gt lt mountpoint gt f r device z B dev cdrom f r lt mountpoint gt z B cdrom U21462 J Z125 7 11 1 1 2 446 AVAS SV Plattform bergreifende Jobsteuerung Installation von AVAS SV Verzweigen Sie nach dem Mounten in das Verzeichnis lt MountPunkt gt und starten Sie die Prozedur mitsh install avs Wenn der Installationsaufruf unter der root Kennung erfolgt wird nach einer Benutzer kennung f r den AVAS Betrieb gefragt und AVAS SV nach HOME AVAS SV installiert Wenn die eingegebene Kennung root ist erfolgt die Installation nach opt AVAS SV und AVAS Jobs k nnen unter jeder Kennung ablaufen Der Programmpfad f r die Dienst programme avslog und avssinjv ist in diesem Fall opt AVAS SV bin Die Installation wird mit einer Fehlermeldung abgebrochen wenn die eingegebene Ken nung im System unbekannt oder das Home Verzeichnis nicht angelegt ist Die Prozedur install avs kann auch unter einer beliebigen Benutzerkennung aufgerufen werden In diesem Fall wird AVAS SV im Verzeichnis AVAS SV unter dem Home Verzeichnis der Kennung installiert und der Programmpfad der Dienstprogramme avslog und avssinjv ist HOME AVAS SV bin Die zu berwachenden AVAS Jobs m ssen unter dieser Kennung ab lauff hig sein Anschlie end werden Sie nach de
490. nutzerkennung und Kennwort sind in den System Parametern ber den Benutzerkreis Bibliotheken zugewiesen Bei einigen Bibliotheken gibt es neben den Bibliotheken die ber den Benutzerkreis zuge ordnet sind entsprechende mit systemweit verf gbaren Elementen JCLSYS DOCSYS NETSYS und JMDSYS Eine Anderung der Zuordnung kann nur durch ndern der System Parameter ber MODIFY SYSTEM PARAMS erreicht werden Die Anderung der Zuordung wird f r alle Benutzer eines Benutzerkreises erst dann wirk sam wenn sich alle Benutzer dieses Benutzerkreises abgemeldet haben Damit werden die Bibliotheken des Benutzerkreises freigegeben Bei der nachfolgenden Anmeldung eines Benutzers mit diesem Benutzerkreis werden die ge nderten Bibliothekszuordnungen ber cksichtigt Eine Bibliothek wird mit dem ersten Zugriff auf diese Bibliothek er ffnet Die Bibliothek bleibt solange er ffnet bis der letzte Benutzer der diese bearbeitet sich von der Kommunika tionsschnittstelle abgemeldet hat U21462 J Z125 7 56 Installation und Generierung Generierung des AVAS Systems Das folgende Diagramm zeigt wann eine Anderung der System Parameter ber MODIFY SYSTEM PARAMS f r einen Benutzer hier USER 1 wirksam wird ZDs ZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZZ USER 1 1111111111111111111111111111111 11111111111111111 USER 2 2222222222222222222222222222222 USER 3 333333333333333333333333333333333 Folge1 aaaaaaaa
491. o7 Vo Vo Vo D o7 NIIT 7o co co 7 7M 7 LO I S REMARK NAME DER AUSGABEDATEI amp AUSGABE 2 ZSET ELLEE LT LINK AVSQUER F NAME amp AUSGABE MODIFY FILE ATTRIBUTES FILE NAME amp AUSGABE SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE SKIP COM TO LABEL FA ENDE FALOAD REMAR FAL REMAR REMARK NAME DER AUSGABEDATEI FUER CALDAYSYMTAB amp CDAYSYM 234 U21462 J Z125 7 Dienstprogramm AVAS QUER Arbeiten mit AVAS QUER LINK AVSCDAY F NAME amp CDAYSYM TTRIBUTES FILE NAME amp CDAYSYM SUPPORT ANY DISK SPACE A CPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMARK NAME DER AUSGABEDATEI FUER NETTAB amp NET SET FILE L LINK AVSNET F NAME amp NET MODIFY FILE ATTRIBUTES FILE NAME amp NET SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMARK NAME DER AUSGABEDATEI FUER NETDOKTAB amp NETDOK FSEI ELLE E LINK AVSNETD F NAME amp NETDOK MODIFY FILE ATTRIBUTES FILE NAME amp NETDOK SUPPORT ANY DISK SPACE RELATIVECPRIMARY ALLOCATION amp SPPR SECONDARY ALLOCATION amp SPSE REMA AME DER AUSGABEDATEI FUER NETSYMTAB amp NETSYM SE LINK AVSNETS F NAME amp NETSYM ECT np rn nr 7 7 rm m r
492. og des Zielrechners ent halten sind Dies f hrt zum Abbruch von Kommandos durch das MAREN System Hinweis Da beim Eintragen von VSNs in die JCL durch MARENAV das Band f r die Ablaufken nung des Jobs reserviert wird darf diese Kennung ber die AVAS Anweisung MODIFY SUBMIT NET Parameter NET USER bzw USER nicht mehr ge ndert werden 6 2 1 Eintragen von VSNs bei Eingabeb ndern Beim Kommando IMPORT FILE SUPPORT TAPE VOLUME VOL DEVICE TYPE device FILE NAME file ersetzt MARENAV den Platzhalter VOL durch eine konkrete VSN Wenn es sich um eine Multivolume Datei handelt wird diese Variable durch eine VSN Liste ersetzt Die VSNs holt sich MARENAV aus dem MAREN Katalog Wenn darin eine Datei mehrfach enthalten ist wird die jeweils neueste Version ausgew hlt Wahlweise kann durch Eingabe von VOL n auch ein lterer Dateistand angefordert werden wobei f r n Wer te zwischen 0 und 9999 zul ssig sind Zum Beispiel wird bei VOLUME VOL 1 von MARENAV der vorletzte Dateistand ausgew hlt und die zugeh rigen VSNs in das betref fende DVS Kommando eingetragen Da im MAREN Katalog derselbe Dateiname in den Archiveintr gen verschiedener Kennungen vorkommen kann muss MARENAV mitgeteilt werden welche Kennung und damit welche VSN in diesem Fall auszuw hlen ist U21462 J Z125 7 263 Eintragen von VSNs in die JCL Kopplung AVAS mit MAREN Dies kann ber folgendes Kommando erreicht werden REMARK UID OWN
493. ogramm heraus aufzurufen und die Verarbeitung programmgesteuert zu kontrollieren F r das Benutzerprogramm gilt beim Aufruf der Programmschnittstelle die Syntax des all gemeinen Unterprogrammaufrufverfahrens wie es bei der jeweiligen Programmiersprache beschrieben wird Bei der Beschreibung der zugelassenen Anweisungen f r die Programmschnittstelle ist vermerkt welche Parameter erforderlich sind Im Verst ndigungsbereich bergibt das Benutzerprogramm die Anweisung mit den Para metern und erh lt als R ckgabe Verarbeitungsinformationen und AVAS Meldungen F r die unterst tzten Programmiersprachen Assembler und Cobol stehen Programm schnittstellen in Form von Makros bzw COPY Elementen zur Verf gung die zu einer problemlosen Kommunikation zwischen dem Benutzerprogramm und AVAS beitragen 10 1 Anweisungen der AVAS Programmschnittstelle In dieser AVAS Version ist die Eingabe folgender Anweisungen ber die Programmschnitt stelle m glich CREATE PLAN NET CREATE PROD NET END MODIFY COND DESCRIPTION RESTART NET SIGNON SUBMIT NET Diese Anweisungen entsprechen den gleichnamigen BATCH Anweisungen die im Kapitel BATCH Funktionen auf Seite 311 beschrieben sind Zus tzlich gibt es f r Administrationszwecke die Anweisung READ AVAS LIBRARY U21462 J Z125 7 373 Programmschnittstelle von AVAS Im Kommunikationsbereich sind die Parameter der Anweisungen ber die folgenden Felder zu
494. omatic3 bs2 userid bs2 account value typ 250 Dienstprogramm AVAS QUER Datenhaltung f r AVAS QUER value char 256 In Abh ngigkeit von value typ Inhalt einer Jobvariablen f r typ JVA Inhalt der Beschreibung f r typ VAL Statustext e f r typ NET JOB RES Wenn mehrere Statuswerte vorhanden sind werden sie mit Komma getrennt ausgegeben Wenn OCCURE VALUE und ERROR VALUE vorhan den sind werden 2 S tze in die ordertab ausgegeben value logic char 2 Logischer Operand f r die Bedingung die der Wert der Jobvariablen erf llen muss M gliche Operandenwerte lt gt lt gt lt gt orderdoktab Die Tabelle orderdoktab enth lt die Zuordnung von Dokumenten zu Strukturelementen bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname indexnr char 3 Indexstufe bkorder char 4 Benutzerkreis der Order ordername char 24 Name des Strukturelements bkdok char 4 Benutzerkreis des Dokumentes dokname char 37 Dokumentname dokvrh char 1 Kennzeichen J N das anzeigt ob das Dokument in der DOCLIB vorhanden ist ordersymtab Die Tabelle ordersymtab enth lt die Zuordnung von Symdats zu Strukturelementen bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname indexnr char 3 Indexstufe bkorder char 4 Benutzerkreis des Strukturelements ordername char 24 Name des Strukturelements symdat char 20 Name des symbolischen Datums Symdat U21462 J Z125 7 251 Datenhal
495. on AVAS QUER erstellten Ausgabedatei en mit Filetransfer bertragen Das Datenbankschema muss erstellt werden Die von AVAS QUER erstellten Ausgabeda tei en aufrufen siehe Seite 246 oder Daten mit DB spezifischen Anweisungen importieren Datenbankabfragen in SQL formulieren siehe Seite 253 oder die Auswertung ber die jewei lige Oberfl che durchf hren System umgebung BS2000 OSD Zielsystem mit Datenbank z B UNIX System mit INFORMIX Dienstprogramm AVAS QUER Arbeiten mit AVAS QUER 5 1 Arbeiten mit AVAS QUER AVAS QUER ist in AVAS integriert Die nachfolgenden Voraussetzungen m ssen erf llt sein um mit AVAS QUER arbeiten zu k nnen 5 1 1 Voraussetzungen f r den Start von AVAS QUER e Der Datei SYSLNK AVAS 070 muss der Linkname SYSLNK zugeordnet werden e In den System Parametern des verwendeten AVAS Systems muss dem Benutzer die COPY ELEMENT Berechtigung f r jene Objekte auf die er zugreifen darf vergeben worden sein e Eine SDF Syntaxdatei die die Anweisungen f r AVAS QUER enth lt muss aktiv sein e Die AVAS Zugriffsprozesse ZDD ZDL m ssen gestartet sein e AVAS QUER ben tigt f r die Erstellung von SQL Statements Ausgabedateien im SAM Format die ber bestimmte Linknamen zugeordnet werden m ssen Bereits bestehen de Ausgabedateien werden berschrieben Abh ngig vom gew nschten Format wer den von AVAS QUER folgende Linknamen erwartet NS
496. on NET NAME und oder PERIOD NAME genauer festgelegt werden Die zu protokollierenden Daten werden aus der aktuellen Jour naldatei JRNDAT ausgew hlt PLANNED NET MODIFICATION Report Der PLANNED NET MODIFICATION Report enth lt alle Netze aus den angegebenen AVAS Dateien an denen nach der Planung eines Netzes ber CREATE PLAN NET nicht planm Bige Ver nderungen vorgenommen wurden Die Ver nderungen sind in der Jour naldatei protokolliert Eine nicht planm ige Ver nderung in diesem Sinne ist e das Andern eines Netzes ber MODIFY PLAN NET e das ndern eines tempor ren Auftrags ber EDIT PROD JOB e das L schen von Auftr gen bei SUBMIT NET e das ndern eines Netzes ber MODIFY SUBMIT NET e das ndern eines Auftrags ber MODIFY SUBMIT JOB Im Report werden alle betroffenen Netze und die von der Modifikation betroffenen Auftr ge innerhalb der Netze mit der Art der Ver nderung ausgewiesen U21462 J Z125 7 281 AVAS Reports Der Umfang der nderungen und die ge nderten Parameter bzw Anweisungen der Auftr ge k nnen den zugeordneten Journalen entnommen werden OUT OF PLAN Report Der OUT OF PLAN Report enth lt alle geplanten Netze aus den angegebenen AVAS Dateien Die aktuellen Werte der Netze werden ber die Journaldatei ermittelt Die aktuellen Werte der Netze in diesem Sinne sind e der aktuelle Status der Netze e die vorgesehene Startzeit EARLIEST START der Netze e eine gegebene Versp tung
497. on erreichen Sie ber die Schaltfl che Benutzer das Eingabefenster Benutzerverwaltung zum Anlegen der Benutzerkennungen Benutzerverwaltung EN Benutzername Passwort be Passwortbest tigung mb Benutzerliste avsUset m Benutzer hinzuf gen Benutzer l schen Benutzerdaten ndern ok Abbrechen Bild 10 Fenster zur Benutzerverwaltung im Programm AVAS Konfiguration 480 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs Eingabefelder des Fensters Benutzerverwaltung Benutzername Benutzername der in die Benutzerverwaltung von AVAS SV aufge nommen bzw aus ihr gel scht werden soll Beim Starten eines Ser ver Jobs wird gepr ft ob die vom BS2000 OSD gesendete Ken nung als berechtigte Kennung eingetragen ist Ist dies nicht der Fall wird der Job abgewiesen Im Feld Benutzername sind keine Leerzeichen erlaubt Die Angabe eines Benutzers in einer bestimm ten Dom ne ist in der Form Dom nenname Benutzername m glich Passwort In dieses Feld muss ein Passwort von maximal 64 Zeichen L nge eingegeben werden wobei zwischen Gross und Kleinschreibung unterschieden wird Passwortbest tigung Best tigen Sie das eingegebene Passwort Achten Sie darauf in beiden Feldern das gleiche Passwort einzugeben Benutzerliste In dieser Auswahlliste sind die berechtigten Benutzer eingetragen Durch Markierung eines Benutzerkennung kann diese f
498. ons hhh mm ss 9 maximale Wartezeit Conditions hhh mm ss 9 mittlere Wartezeit ERROR hhh mm ss 9 maximale Wartezeit ERROR hhh mm ss 9 mittlere Anzahl ERROR 000 00 999 99 6 Anzahl Zeiten nn 2 Plan Start Datum Zeit YYYYMMTThhmmss 14 Laufzeit Netz 1 hhh mm ss 9 Sicherung und Reorganisation Aufbau der History Datei Spalten berschriften Inhalt Lange Laufzeit Jobs 1 hhh mm ss 9 Wartezeit Conditions 1 hhh mm ss 9 Wartezeit ERROR 1 hhh mm ss 9 Anzahl ERROR 1 nnn 3 Plan Start Datum Zeit YYYYMMTThhmmss 14 Laufzeit Netz 64 hhh mm ss 9 Laufzeit Jobs 64 hhh mm ss 9 Wartezeit Conditions 64 hhh mm ss 9 Wartezeit ERROR 64 hhh mm ss 9 Anzahl ERROR 64 nnn 3 U21462 J Z125 7 217 Sicherung und Reorganisation Lange Cc N ojojo 0 7 xo dodo o 02 gt WO A U21462 J Z125 7 Inhalt KEY 02 bk netname SYMDAT NAME IND bk jobname FU J P X TYPE SUM tt mm yyyy hh mm ss hhh mm ss tt mm yyyy hh mm ss nnnn hhh mm ss hhh mm ss hhh mm ss hhh mm ss hhh mm ss hhh mm ss hhh mm ss 000 00 999 99 nn YYYYMMTThhmmss hhh mm ss hhh mm ss nnn YYYYMMTThhmmss hhh mm ss hhh mm ss nnn Aufbau der History Datei KEY 02 History Job komprimiert Spal
499. ontrol time Intervall zwischen zwei Aktionszyklen der Ablaufsteuerung in dem das Erreichen der vorgesehenen Startzeit freigegebener Netze gepr ft wird Zeitangabe in Sekunden Hinweis Der Parameter hat einen gro en Einfluss auf den CPU Verbrauch der Ablaufsteuerung und der Zentralen Zugriffsprozesse In der angegebenen Taktzeit werden die Inhaltsverzeichnisse der Ablauf datei nach zu startenden Netzen durchsucht F r den Betrieb sollte eine Zeit nicht unter 30 Sekunden angegeben werden routing code Routingcode f r Mitteilungen von der Ablaufsteuerung Berechtigungsschl ssel f r die zugeordneten Bedienpl tze Standardwert ist Hauptbedienstation siehe Handbuch Einf h rung in die Systembetreuung 7 jvavak Name einer Jobvariablen zur berwachung der Ablaufsteuerung Die Jobvariable wird beim Start des Prozesses von diesem einge richtet Wenn von RZ Routinen die Kontrollanweisung NETC eingetragen werden soll ist der Name mit vollst ndigem Pfadnamen zu definie ren Es ist daf r zu sorgen dass die Funktionsprozesse schreibend auf die Jobvariable zugreifen k nnen U21462 J Z125 7 35 Generierung des AVAS Systems Installation und Generierung mscf control time Wartezeit nach HOSTWAIT in Sekunden Nachdem die Verbindung zu einem ausgefallenen Remote Rechner wieder zu Stande gekommen ist wartet die Ablaufsteuerung die angegebene Zeit bis neue Jobs auf diesem Rechner gestartet werden Nach dieser Wartezeit m sse
500. ormat von AVAS V3 0A Ausgabedatum ohne Jahrhundert bergeben Im RZ Exit AVEX0002 werden die Journals tze im Format Ausgabedatum mit Jahrhun dert bergeben Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie folgt pfixNNAM Ausgabe Parameter Netzname pfixFUNK Ausgabe Parameter AVAS Funktion pfixAKTN Ausgabe Parameter AVAS Aktion pfixJSSL Ausgabe Parameter Journal Satzschl ssel pfixJFNR Ausgabe Parameter Journal Satzfolgenummer pfixADRJ Ausgabe Parameter AVEX0001 Der Journalsatz wird im Format der AVAS Versionen 2 0A und 3 0A ber geben ohne Jahrhundert bergabebereich F35 AVASJRN amp pfix VERSION 020 AVEX0002 Der Journalsatz wird im Format der AVAS Version ab 4 0A bergeben mit Jahrhundert bergabebereich F35 AVASJRN amp pfix VERSION 070 Adresse des Journalsatzes siehe Abschnitt Satzaufbau des festen Teils der Journals tze auf Seite 197 pfixDFIX Ausgabe Parameter EQUATE f r L nge des Basisdatenteils U21462 J Z125 7 81 RZ Exits im AVAS System Installation und Generierung R ckgabe der RZ Routine an AVAS Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden pfixOK EQU X 00 Der Journalsatz soll in die Journaldatei ausgegeben werden pfixNO EQU X 04 Der Journalsatz soll nicht in die Journaldatei ausgegeben werden Der Returncode wird ignoriert wen
501. ort wird immer nach dem Netznamen sor tiert F r die Sortierreihenfolge sind keine Anweisungen erforderlich 288 U21462 J Z125 7 REPORT Anweisungen AVAS SYSTEM ID AVAS USER ID 7 2 REPORT Anweisungen AVAS SYSTEM ID Ausw hlen des AVAS Systems Mit AVAS SYSTEM ID wird das AVAS System ausgew hlt von dem ein Report erstellt wer den soll Die Anweisung muss nur bei FUNKTIONZCREATE angegeben werden AVAS SYSTEM ID string 7 Zeichen langer Name des AVAS Systems f r das ein Report erstellt werden soll ber die Anweisung werden die zentralen Zugriffsprozesse ausgew hlt Wenn einer der Zugriffsprozesse ZDD oder ZDL nicht aktiv ist wird folgende Meldung nach SYSOUT ausgegeben AVS7521 ZDD string NICHT AKTIV AVAS USER ID Ausw hlen des Produktionsplans Mit AVAS UDER ID wird der Produktionsplan NPRLIB ausgew hlt der dem angegebenen Benutzer ber die AVAS System Parameter zugeordnet ist Wenn im System mehrere Produktionspl ne definiert sind m ssen sie nacheinander zur Auswertung ausgew hlt werden Die Anweisung muss nur bei FUNKTIONZCREATE angegeben werden AVAS USER ID avuser Identifikation maximal 8 Zeichen eines AVAS Benutzers der in den System Parametern definiert ist und dem der auszuwertende Produktionsplan zugeordnet ist Die Funktionsberechtigung des Benutzers f r die Anweisung SHOW PLAN NET wird zur Erstellung des Reports nicht berpr ft Der Produktionsplan wird f r alle angegebenen Benutze
502. ournaldatei 3ENDL EQU 126 NO DELETE 3ESVD EQU 127 SAVED 3EUPD EQU 129 UPDATED 3ENUP EQU 130 NO UPDATE 3ECND EQU 131 CANCELLED 3ENCN EQU 132 NO CANCEL 3ENSB EQU 133 NO SUBMIT 3ENCH EQU 136 NO CHANGE 3ECHD EQU 137 CHANGED 3ESHD EQU 154 SHIFTED 36008 EQU 155 OCCURED 3ENOC EQU 156 NO OCCURE 3EHTW EQU 173 HOSTWAIT SUSER DS CL8 BENUTZER lt AVUSER gt 003101 31 DS CL3 INDEX CMD 3JC DS c FU A C D J M N P W CMD EQU YES JC AVASEQU N3 VERSION 070 FUNCTION 3EFUA EQU CA ADD 3EFUC EDU GC COMPARE 3EFUD EQU CD DELET 3EFUJ EQU C J START JOB 3EFUM EQU Cu MODIFY SEFUN EQU C N NET 3EFUP EQU C P START PROCEDURE 3EFUS EQU C S START 3EFUM EQU C W WAIT 3EFUX EQU C X SERVER JOB 3NAME DS CL32 NAME NETZ JOB CONDITION CMD 3DAT DS 001320 DATENSATZ MAX L 320 CMD 3DSSL DS 602 DATENSATZ SCHLUESSEL CMD 3DFNR DS CL2 DATENSATZ FOLGENUMMER CMD 3FLEN EQU N3JOURN LAENGE FIXER TEIL 3INH DS 601316 DATENSATZ INHALT MAX L 316 CMD 003101 3LE EQU N3JOURN MAX LAENGE EINTRAG U21462 J Z125 7 199 Datenstrukturen Journalsicherung Not Journaldatei Sicherung und Reorganisation Satzaufbau des variablen Teils der Journals tze Es ist zu beachten dass die Definitionen f r den variablen Teil dem Feld INH hier N3INH berlagert werden m
503. ows Jobs Der Windows Job nt_loesch cmd startet einen mySAP com Job mit dem Namen LOESCHJOB der aus einem Job Step besteht Im Job Step 1 wird das ABAP 4 Programm RSBTCDEL mit der Variante EICH FERTIG zum Ablauf gebracht Die Destination DESTZB4OHELIOS muss in der Datei saprfc ini der Benutzer USER AVASS in der Datei sapuser ini gepflegt sein Die LOG Datei wird im Verzeichnis c NavasNavasr3 linkNLOG Dateien mit dem Namen loeschjob log angelegt Beim Start von avasr3 aus der Windows Shell wird der Inhalt der LOG Datei im aktuellen Fenster ausgegeben Zus tzlich kann man sich noch den Exit Code ausgeben lassen Job nt loesch ocmd rem Start eines R 3 Jobs aus der Windows Shell rem set AVASR3PATH c avas avasr3_link set AVASR3LOGFILE AVASR3PATH LOG_Dateien loeschjob 1og set RFC_INI AVASR3PATH saprfc ini rem set DEST BAOHELIOS set USER AVAS3 rem set JOBNAME LOESCHJOB set PROGRAMI RSBTCDEL set VARIANTI EICH FERTIG rem set AVASR3_CALL destination DEST user USER job JOBNAME set AVASR3_CALL AVASR3_CALL programl PROGRAM1 variantl VARIANT1 rem rem Start von 3 rem AVASR3PATH avasr3 exe AVASR3_CALL rem rem rem Auswertung der Ergebnisse rem goto Exit ERRORLEVEL Exi tO rem Job OK beendet set ERGEBNIS JOB OK BEENDET goto Ende Exitl U21462 J Z125 7 509 Steuerung von SAP R 3 Jobs mit 5 AVAS SV Plattform bergreifende Jobsteuerung Job wurde abgebrochen
504. ozesses wurde gefordert Der Prozess beendet sich wenn sich kein Benutzer mehr angemeldet hat KILL Sofortige Beendigung des Prozesses wurde gefordert nur ZDs Der Prozess beendet sich sofort IN JRLDAT Von der UPAM ZD wurde die Funktion Einmischen der Notjourna le durchgef hrt Beispiel An die Ablaufsteuerung wird das Kommando INFORM PROG MSG STOP LEVEL NET JOB ID lt tsn gt gegeben Es befinden sich noch Netze im Ablauf Nach der Eingabe von SHOW JV JV IDENTIFICATION JV NAME jvavak erfolgt die Aus gabe RUNNING STOP RUNNING Das bedeutet dass die Eingabe angenommen wurde aber noch Netze im Ablauf sind Wenn sich diese Netze beendet haben beendet sich auch die Ablaufsteuerung Nach einer erneuten Eingabe von SHOW JV JV IDENTIFICATION JV NAME jvavak erfolgt die Ausgabe ENDED READY RUNNING STOP RUNNING Wenn zum Zeitpunkt des Kommandos INFORM PROG MSG STOP LEVEL NET JOB ID lt tsn gt keine Netze im Ablauf waren dann wird direkt ausgegeben ENDED READY STOP READY In den Jobvariablen werden immer die letzten f nf Verarbeitungszust nde angezeigt 134 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb 3 3 Administrationsaufgaben im Betrieb 3 3 1 Verwalten der Systembibliotheken Zum Verwalten der Systembibliotheken gibt es folgende Anweisungen COPY SYSTEM ELEMENT Kopieren von Elementen in eine zentrale Bibliothek DELETE SYSTEM ELEMENT Loschen von Elementen
505. plattform bertra gen gesteuert und berwacht Das Programm avasr3 wird ab AVAS SV V4 1A ausgeliefert und kann derzeit mit mySAP com Systemen der Release St nde 3 1 4 0 4 5 und 4 6 kommunizieren Einbindung von avasr3 in die Jobsteuerung von mySAP com mySAP com ist eine Komplettl sung mit einem integrierten Computing Center Management System CCMS das u a die Definition und Abwicklung von Batchabl ufen erm glicht CCMS Job Scheduling System Ein mySAP com Job ist kein Job im Sinne des jeweiligen Betriebssystems auf dem mySAP com l uft sondern eine mit mySAP com Sprachmitteln definierte Vorgabe f r einen Batchablauf die innerhalb von mySAP com gespeichert und durch mySAP com abgewickelt wird Vorgegeben wird eine Folge von Job Steps Ein Step kann der Aufruf eines ABAP 4 Programms oder eines Programms au erhalb von mySAP com sein Ein externes Programm kann ein Programm oder ein Betriebssystem Job sein mySAP com Jobs k nnen ber mySAP com Dialogfunktionen oder aus ABAP 4 Program men definiert und gestartet werden Durch Zuordnung einer Startzeit wird die Abwicklung durch das CCMS Job Scheduling System angesto en mySAP com bietet die Schnittstelle XBP an um externe Job Management Systeme an mySAP com anzubinden XBP steht dabei f r eXternal Interface for Job Background Pro cessing Die Aktivit ten des mySAP com CCMS Job Scheduling Systems sowie die Definition von mySAP com Jobs der Start und die Status Abfra
506. portnr 123 22 84 456 7777 userid avas comm pw PASSWCOM dir home avas test pfad home avas work Editieren der AVAS Konfigurationsdatei Zum Editieren der AVAS Konfigurationsdatei wird die Prozedur AVS EDITCONFIG in der Bibliothek SYSPRC AVAS 070 ausgeliefert 462 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs 11 3 2 Starten des AVAS Agenten AVSSINCM Zum Starten des AVAS Agenten setzt die Ablaufsteuerung einen ENTER PROC Aufruf auf die in SERVER PROCEDURE NAME angegebene Datei ab Dabei werden Eingaben f r AVSSINCM durch Prozedur Parameter vorgegeben Die folgende Startprozedur wird mit den brigen AVAS Prozeduren ausgeliefert sie muss zum Start von AVSSINCM bereitgestellt werden SET PROCEDURE OPTIONS LOGGING ALLOWED YES DATA ESCAPE CHAR STD BEGIN PARAMETER DECLARATION DECL PARAM USERID INIT ECL PARAM CNTAPP INIT ECL PARAM CNTAPC INIT ECL PARAM AVS AVAK FILE ECL PARAM AVS AVAK NAME ECL PARAM AVS CONF FILE ECL PARAM AVS CONF PASSW ECL PARAM AVS JOB ID ECL PARAM AVS JOB INDEX ECL PARAM AVS JOB NAME ECL PARAM AVS JOB TYPE ECL PARAM AVS MONJV PASSW ECL PARAM AVS NET NAME ECL PARAM AVS SERVER NAME ECL PARAM AVS SERVER PASSW ECL PARAM AVS SERVER PARAM ECL PARAM AVS SERVER VERSION ECL PARAM AVS SYSTEM ID ECL PARAM AVS AVAS VERSION ECL PARAM AVS AVAK FILE PASSW ECL PARAM AVS JOB CLASS ECL PARAM AVS JOB LOG ECL PARAM
507. prozedur f r den Einsatz individuell ge ndert werden muss Bibliotheken F r den Ablauf der BATCH Funktionen werden die Bibliotheken SYSLNK AVAS 070 und SYSPRG AVAS 070 SYSTEM ben tigt Prozedur AVS BATCH BEGIN PROC LOG N PAR YESCPROC PAR amp EXEC START 7 amp USERID amp CMDFILE ESC CHAR C amp REMARK 6 kk kk de kk kk de ke kk b ke kk kh he ke kk he ke kk b he ke kk b he ke kk he KEK ke kk bebe REMARK amp USERID BENUTZERKENNUNG DER AVAS INSTALLATION REMARK lt REMARK amp CMDFILE DATEI MIT DEN FUNKTIONSANWEISUNGEN FUER AVAS R EMAR SET FILE LINK F NAME amp USERID SYSLNK AVAS 070 LINK SYSLNK ASSIGN SYSDTA TO FILE amp CMDFILE amp EXEC PROG FROM FILE PHASECLIB 8 amp USERID SYSPRG AVAS 070 SYSTEM ELEM AVAS SYS LOAD BATCH ASSIGN SYSDTA TO FILE PRIMARY REMOVE FILE LINK LINK NAME SYSLNK SKIP CO TO LABEL SW30SET IF JOB SWITCHES ON 30 SKIP CO TO LABEL SW31SET IF JOB SWITCHES ON 31 SKIP CO TO LABEL ENDE SW30SET REMAR WRITE TEXT gt AVAS ABLAUF MIT WARNING gt j MODIFY JOB SWITCHES OFF 30 SKIP C
508. r Ablaufdatei und der Journal datei ist Folgendes zu beachten e Ein Netz im Produktionsplan das ber SUBMIT NET bzw REPEAT NET zur Produktion freigegeben wurde kann mit DELETE PLAN NET erst gel scht werden wenn es bei einer Reorganisation in der Ablaufdatei gel scht wurde Netze die nicht zur Produktion freigegeben wurden kein SUBMIT NET bzw REPEAT NET k nnen jederzeit ber DELETE PLAN NET YES gel scht werden e Voraussetzung f r das L schen in der Ablaufdatei ist der Netzstatus ENDED SHIFTED oder ABENDED e Die Journals tze eines Netzes werden erst dann gesichert wenn das Netz mit DELETE PLAN NET gel scht wurde Netzstatus in der Journaldatei ist DELETED e Die Journale eines Netzes werden in der Journaldatei gel scht wenn sie im vorausge gangenen Reorganisationslauf gesichert wurden Netzstatus in der Journaldatei ist DELETED SAVED U21462 J Z125 7 164 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien Damit ergibt sich f r zur Produktion freigegebene Netze die in der Ablaufdatei den Status ENDED SHIFTED oder ABENDED erreicht haben folgender L schzyklus 1 Bei der folgenden Reorganisation werden die Netze in der Ablaufdatei gel scht 2 Die Netze m ssen mit DELETE PLAN NET im Produktionsplan gel scht werden Die Anweisung wird bei der Reorganisation der Ablaufdatei automatisch abgesetzt wenn diese mit dem Parameter DELETE PLAN NET YES gestartet wird 3 Bei der folge
509. r Restart 527 AVOSEXTV Modul 76 avak 35 avak use 29 AVAS Konfiguration Programm 479 AVAS Windows Dienst 448 452 AVAS SYS LOAD SVDOG Server berwachung 124 AVAS Ablaufsteuerung Betrieb 104 AVAS Administrator 103 AVAS Agent AVSSINCM 454 456 AVSSTRT 472 AVAS Anweisungen symbolische Namen 44 AVAS Benutzer 30 AVAS Bibliotheken 24 56 AVAS Dateien einrichten 53 AVAS DOORS 6 Hardware Voraussetzungen 63 Installation 16 64 Konfiguration 65 Masken 65 Software Voraussetzungen 64 starten 65 AVAS EXIT Modul 74 AVASEXKO Makro 80 AVASJRN Makro 187 546 Stichw rter AVEX0403 RZ Exit 70 8 AVEX2001 RZ Exit 71 90 AVEX6601 RZ Exit 71 91 AVEX6602 RZ Exit 71 93 AVEX6801 RZ Exit 72 4 AVEX6802 RZ Exit 72 96 AVEX7101 RZ Exit 73 98 AVEX7102 RZ Exit 73 99 259 AVEXSVV Makro 76 AVS Startparameter f r AVSSINCM 465 AVS GENPERIOD Prozedur f r Standard Perioden 323 AVS SVDOG Startprozedur 125 AVSASSAD Makro 389 AVSASSAN Makro 393 AVSASSBC Makro 348 400 AVSASSBO Makro 404 AVSASSBW Makro 405 AVSASSCD Makro 407 AVSASSCE Makro 409 AVSASSJD Makro 1 AVSASSJN Makro 414 AVSASSRT Makro 416 AVS AVAK FILE 465 AVS AVAK FILE PASSWORD 466 AVS AVAK NAME 465 AVS AVAS VERSION 466 AVSCMDG Schl ssel definieren 1 AVSCOBAD COPY Element 421 AVSCOBAN COPY Element 423 AVSCOBBC COPY Element 427 AVSCOBBO COPY Element 430 AVSCOBBQ COPY Element 1 AVSCOBBW COPY El
510. r die Fehler ursache keinen passenden MAREN Meldungsschl ssel so wird einer der folgenden Texte bergeben CATALOG catid NOT ACCESSIBLE Der Versuch den TSOSCAT Eintrag einer Datei zu lesen wurde mit einem der DVS Fehlercodes DMS0501 bis DMS0505 oder DMS0512 abgelehnt d h der entsprechen de Katalog ist nicht verf gbar Die Produktionsfreigabe wird abgebrochen Sie kann erst dann wieder durchgef hrt werden wenn alle von dem betreffenden Netz angesproche nen Kataloge verf gbar sind CATID x NOT CONTAINED IN LOCATION FILE Zur angegebenen Katalogkennung befindet sich kein Eintrag in der zugewiesenen Lagerortdatei Die Produktionsfreigabe wird abgebrochen Vor einer Wiederholung des SUBMITS ist die Lagerortdatei zu aktualisieren Diese Meldung wird auch verwendet falls weder im Dateinamen eine Katalogkennung angegeben noch eine solche von AVAS am SUBMIT Exit bergeben wurde und sich in der Lagerortdatei kein Eintrag mit einer leeren d h nur aus 4 Leerzeichen bestehenden CATID befand LOCATION locname NOT ALPHANUMERIC Einer der in der zugewiesenen Lagerortdatei enthaltenen Lagerorte ist nicht vom Datentyp alphanumerisch M glicherweise ist der Lagerortname k rzer als 8 Byte und wurde nicht rechtsseitig mit Leerzeichen aufgef llt Die Produktionsfreigabe wird abge brochen VALUE FOR OPERAND VOLUME NOT CORRECT Der Platzhalter wurde syntaktisch falsch eingegeben Beispielsweise fehlen die Klammern oder die angegebene Da
511. r durch unzureichende Antwortzeiten der Dialogkomponenten dann k nnen diese sowohl durch organisatorische als auch durch anwendungstechnische MaBnahmen behoben werden Um das AVAS System optimal zu nutzen werden f r den Benutzer folgende Ma nahmen aufgezeigt Organisatorische Ma nahmen Beim Einsatz von AVAS ergeben sich vielf ltige M glichkeiten den zeitlichen Ablauf von Produktionsplanung Produktionsvorbereitung Produktionsfreigabe und Produktionsdurch f hrung zu entzerren Alle Arbeitsschritte k nnen weitgehend zeitlich versetzt ausgef hrt werden F r den zeitlichen Ablauf der Arbeiten k nnen die grunds tzlichen Regeln aufgestellt werden e Die Terminplanung ber den Kalender sollte f r einen m glichst gro en Zeitraum im Voraus erfolgen 1 3 Monate oder mehr Die Anweisungen stellen keine wesentliche Belastung des Systems dar und erzeugen keine redundanten Datenmengen e Die Produktionsplanung sollte f r einen mittleren Zeitraum im Voraus erfolgen je nach Produktionsumfang bis zu 14 Tage oder 2 Monate Die Produktionsplanung ist keine kritische Funktion und erzeugt nur kleine redundante Datenmengen modifizierte Netz struktur F r den gleichen Zeitraum im Voraus kann auch die Sammlung von Netz parametern ber COLLECT NET PARAMS vorgesehen werden Dabei entstehen nur begrenzte und keine redundanten Datenmengen Eine Aktualisierung der Daten ist jederzeit m glich und nicht aufw ndig e Die Parametermodifik
512. ramm ext Endung des zu verwendenden AVAS DATEINAME cmd Aufruf des gew nschten Programms AVAS DATEINAME F r AVAS DATEINAME wird der Name und Pfad des Jobs auf dem Rechner eingetragen Da dies ein interner vom AVAS Server ver gebener Name ist muss der Bezeichner nicht angegeben werden Die Erweiterung ext wird falls angegeben angeh ngt param Optional k nnen Parameter angegeben werden Nach Auswertung aller Informationen muss eine g ltige UNIX Anweisung entstehen die anschlie end anstelle des normalen Programmaufrufs ausgef hrt wird Beispiel AVAS CALL bin sh AVAS DATEINAME in prot hi puffer out F 002 11 3 5 Ablaufsteuerung und kontrolle f r Windows Systeme F r Windows Systeme wird eine geschlossene L sung mit dem AVAS Agenten AVSSINCM und dessen AVAS Server als Windows Dienst AvasService angeboten Der Start von Abl ufen auf dem Windows System erfolgt wie bei UNIX Systemen Strukturelemente mit FUNCTION X starten ber den Agenten AVSSINCM der AVAS Ablaufsteuerung Prozesse auf dem Windows Rechner Dazu m ssen die Adresse und die Portnummer des Rechners in die Konfigurationsdatei eingetragen werden In AVAS Bibliotheken gespeicherte Windows Skripts m ssen der Windows Syntax ent sprechen 476 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs Architektur und Kommunikation Ablaufsteuerung Windows Systeme BS2000 OSD Windows Syst
513. rarbeitung der mit HOLD NET angehaltenen Netze oder Strukturelemente von Netzen wieder fortgesetzt werden Die Abarbeitung des Netzes wird an den Stellen wieder aufgenommen an denen die Verarbeitung mit HOLD NET unterbro chen wurde Die Verarbeitung des Netzes erfolgt wie bei einem nicht unterbrochenen Netz Der erforderliche Netzstatus vor der Ausf hrung der Anweisung ist HOLD oder CALLED FOR HOLD nur wenn die Ablaufsteuerung den geforderten HOLD noch nicht verarbeitet hat Nach der Ausf hrung von RESUME NET befinden sich die Netze im Status RUNNING CONDWAIT oder HOSTWAIT wenn die Ablaufsteuerung das Netz bereits aktiviert hat oder im Status WAITING OPWAIT RESTART ERROR oder START Wenn nicht alle Hal tezust nde im Netz aufgehoben wurden hat das Netz zus tzlich den Status CALLED FOR HOLD RESUME NET NET NAME S bk netname INDEX index PERIOD NAME period date time date time RUN CONTROL SYSTEM avak Der Parameter NET NAME muss angegeben werden der Parameterwert kann teilqualifi ziert angegeben werden mit als Maskierungszeichen Der Parameter INDEX ist nur in Verbindung mit einem vollqualifizierten Netznamen zuge lassen Wenn der Parameter INDEX angegeben wird wird f r diesen Index der HOLD Zustand aufgehoben Der Parameter PERIOD NAME ist nur in Verbindung mit einem teilqualifizierten Netzna men zugelassen Wenn der Parameter RUN CONTROL SYSTEM nicht angegeben wird wird der Name der Ablau
514. ration von AVAS 3 3 5 1 Systemoptimierung bei BATCH Betrieb Bei intensiver Nutzung der BATCH Funktionen kann es zu Zeitproblemen bei der Abarbei tung der AVAS Anweisungen ber BATCH kommen insbesondere dann wenn AVAS BATCH innerhalb von AVAS Netzen zum Ablauf gebracht wird Erkennbare u ere Anzeichen f r kritische Betriebszust nde sind e Bei der Vorbereitung von Netzen ber AVAS BATCH wird f r ein Netz oder mehrere Netze RESULT LOCKED angezeigt e Die Ablaufdatei und die Journaldatei zeigen f r ein Netz vor bergehend einen unter schiedlichen Status an e Die Laufzeit von Netzen mit Jobs in denen AVAS BATCH Anweisungen abgesetzt wer den steigt erheblich an e Beiden Anweisungen CREATE PROD NET und oder SUBMIT NET wird bei einem oder mehreren Netzen RESULT ERROR angezeigt weil zugeordnete Jobs nicht gelesen werden k nnen Verursacht werden diese Betriebszust nde durch sich aufbauende Warteschlangen an den Zugriffsschnittstellen f r die Ablaufdatei ABLDAT die Journaldatei JRNDAT und die Biblio theken und damit auch im Bereich der zentralen Zugriffsprozesse ZDD und ZDL Um kritische Betriebszust nde zu vermeiden ist es grunds tzlich erforderlich die Wieder holung von Zugriffsfolgen wegen gesperrter Elemente oder Bl cke zu verhindern oder zu mindest zu minimieren Dies wird erreicht ber den Generierungs Parameter MAX BATCH PROCESS siehe Seite 23 und die Anweisungen MAX SERIAL LOCK und MAX SERIAL W
515. ration von AVAS Starten und Beenden der AVAS Prozesse SPD catid vsn dev Beschreibung des externen Datentr gers Shareable Private Disc auf den AVAS im Mehrrechnerbetrieb die ENTER Dateien anlegen soll catid Name des Katalogs vsn Name des Datentr gers dev Ger tetyp gem Ger tetabelle z B D3437 f r Plattenspeicher 3437 und 3437 2 Die Werte f r SPD sind anzugeben wenn in einem Rechnerver bund Jobs ber eine Shareable Private Disc ablaufen sollen und SPVS nicht beschrieben wird Hinweis Die Anweisung SPVS oder SPD darf nur angegeben werden wenn Jobs in einem Rechnerverbund verteilt werden sollen Vor dem Start der Ablaufsteuerung muss das Mehrrechnersystem ablauff hig sein RESTORE MONJV VALUE YES Der Inhalt der Auftrags Jobvariablen Stelle 129 256 soll bei der Endebehandlung des Jobs durch AVAS gesichert werden wenn der Jobbeschreibungssatz in der Ablaufdatei den Status ENDED oder ERROR erh lt Bei einem erneuten Ablauf des Jobs nach einem Restart soll der gesicherte Inhalt wieder in der Auftrags Jobvariab len zur Verf gung stehen NO Der Inhalt der Auftrags Jobvariablen soll nicht gesichert werden Standardwert der Startprozedur Hinweis Wenn der Inhalt der Auftrags Jobvariablen von der Ablaufsteuerung gesichert wird ist im Jobablauf daf r zu sorgen dass bei jedem erneuten Ablauf des Jobs in der Auftrags Jobvariablen Stelle 129 256 die richtige Information enthalten ist Aus Sich
516. rden e Die Verschl sselung greift nur f r Kennw rter die in der Netzbeschreibung enthalten sind ENTER PARAMS LOGON wird nicht unterst tzt U21462 J Z125 7 21 Generierung des AVAS Systems Installation und Generierung 2 2 2 Beschreibung der System Parameter 2 2 2 1 Definitionen f r die zentralen Zugriffsprozesse Die System Parameter der zentralen Zugriffsprozesse definieren den Umfang und den Zugriff auf die Daten des AVAS Systems Einige dieser System Parameter sind im laufen den Betrieb von AVAS nicht mehr zu ndern sondern nur durch einen erneuten Generie rungslauf F r folgende Bereiche der zentralen Zugriffsprozesse sind System Parameter zu definieren e allgemeine Parameter der zentralen Zugriffsprozesse e Dateinamen der Bibliotheken e Dateinamen der Ablaufdatei und der Journaldatei Allgemeine Parameter der zentralen Zugriffsprozesse Die allgemeinen Parameter sind im laufenden Betrieb nicht zu ndern d h sie werden unver ndert aus der System Parameterdatei SYSPAR gelesen AVAS SYSTEM ID string 7 Zeichen lange Zeichenkette die das AVAS System identifiziert JVCENTRAL jvname Name der Jobvariablen zur Uberwachung des CENTRAL Prozes ses JVPLAMZD jvname Name der Jobvariablen zur berwachung der PLAM ZD JVUPAMZD jvname Name der Jobvariablen zur berwachung der UPAM ZD Mit den Jobvariablen werden die ZDs berwacht Sie verhindern ein zweites Laden der ZDs Die Jobvariablen werden beim Start der
517. rden Sie beschreiben die zugelassenen Benutzer des AVAS Systems mit ihren Funktionsberechtigungen und ihrer Zuordnung zu einem Benutzerkreis Folgende Angaben sind zu definieren Parameter der Benutzerkreise Parameter der Benutzer Allgemeine Parameter der Benutzer Parameter der Dateizuordnungen Parameter der Funktionsberechtigungen Systemvariable S nnn der Benutzer Definition der Benutzerkreise Mit der Definition eines Benutzerkreises wird eine Gruppe von AVAS Bibliotheken als zusammengeh rig definiert Bei der Definition der Benutzerkreise ist zu unterscheiden zwischen einem Systembenutzerkreis und Benutzerkreisen denen einzelne Benutzer 2 8 nach ihrem Aufgabengebiet zusammengefasst zugeordnet sind e Der Systembenutzerkreis wird mit dem Schl sselwort BKSYS definiert Diesem Benut zerkreis m ssen die Systembibliotheken auf die systemweit alle Benutzer zugreifen k nnen zugeordnet werden Ein Systembenutzerkreis muss bei der Generierung immer definiert werden Seine Definition kann im laufenden AVAS Betrieb nicht gean dert werden BKSYS bk NETSYS JCLSYS JMDSYS DOCSYS LOGSYS bk Name des Systembenutzerkreises maximal 4 Zeichen davor muss das Zeichen sein NETSYS Schl sselwort der Systembibliothek f r Netzbeschreibungen JCLSYS Schl sselwort der Systembibliothek f r Jobs und JCL Bausteine JMDSYS Schl sselwort der Systembibliothek f r ablauff hige Jobs DOCSYS Schl sselwort der
518. re Protokolle gibt wird bei den Funktionen SHOW NET STATUS und SHOW JOURNAL ber die Operation JOBLOG nur das erste Protokoll angezeigt Es ist daher sinnvoll die Datei mit der ASSIGN SYSOUT Zuweisung als erste Datei zu signalisieren U21462 J Z125 7 147 Administrationsaufgaben im Betrieb Administration von AVAS e Auftr ge vom TYPE EXX k nnen mit dem SIGNAL Programm nur arbeiten wenn die externe Uberwachungs Jobvariable als Auftrags Jobvariable ber den Dateikettungs namen SMONJVJ ansprechbar ist Starten des TRANSFER Programms Das Programm TRANSFER fordert den Prozess CENTRAL auf die angegebene Protokoll datei einzusammeln Wenn CENTRAL die Datei nicht selbst lesen kann bertr gt TRANSFER sie mit DCAM Dazu ben tigt TRANSFER den Zugriff auf die Auftrags Job variable Die bertragung erfolgt im gleichen Job oder in einem Folgejob e F rdie bertragung im gleichen Job wird die Prozedur AVS TRANSFER Element der Bibliothek SYSPRC AVAS 070 oder eine selbst erstellte Prozedur oder Kommando folge in den AVAS Job aufgenommen e Die bertragung in einem Folgejob wird ber den Parameter TRANSFER OPTION beim Programm SIGNAL gesteuert Vor dem Aufruf des TRANSFER Programms sollten die Protokolldateien wenn m glich f r den CENTRAL Prozess zugreifbar gemacht werden z B durch das BS2000 Kommando MODIFY FILE ATTRIBUTES ber SYSDTA k nnen folgende Parameter zur Steuerung des Ablaufs von TRANSFER vor gege
519. reiches Stichwortverzeichnis mit allen Stichw rtern der B nde 1 5 enthalten Bestellnummern U2338 J Z125 16 Kommandos Band 1 A C U41074 J Z125 3 Kommandos Band 2 D MOD JO U21070 J Z125 6 Kommandos Band 3 MOD JV R U41075 J Z125 3 Kommandos Band 4 S SH PRI U23164 J Z125 5 Kommandos Band 5 SH PUB Z U23164 J Z125 4 Kommandos Band 5 SH P Z 10 BS2000 OSD BC V6 0 Kommandos Band 6 Ausgabe in S Variablen und SDF P BASYS Benutzerhandbuch Zielgruppe Das Handbuch wendet sich an Programmierer und Anwender die Prozeduren erstellen Inhalt Band 6 enth lt die tabellarische Darstellung aller S Variablen die von den SHOW Kom mandos bei einer strukturierten Ausgabe mit Werten versorgt werden Weitere Kapitel Einf hrung in das Arbeiten mit S Variablen SDF P BASYS V2 3A Bestellnummer U23165 J Z125 5 542 U21462 J Z125 7 Literatur 11 MAREN V10 0A BS2000 OSD Band 1 Grundlagen der MBK Verwaltung Benutzerhandbuch Zielgruppe Das Handbuch wendet sich an alle BS2000 Anwender RZ Organisatoren Operatoren und Systembetreuer Inhalt Band 1 enth lt eine Einf hrung in die Arbeit mit MAREN Es werden u a folgende Themen beschrieben Der MAREN Katalog Die Verwaltung von MBKs und Lagerorten Der Einsatz von Dom nen und die damit verbundenen Benutzerrollen DerEinsatz einer Reservierungsdatei zur Datentr ger Zuweisung bei Neureservierung und deren Bearbeitung mit MARENLM
520. rkreise ausgewertet U21462 J Z125 7 289 END FUNKTION REPORT Anweisungen END Beenden der Anweisungsfolge an den REPORT Generator Mit END wird eine Anweisungsfolge f r den REPORT Generator abgeschlossen Nachfolgende Anweisungen werden nicht verarbeitet Sie werden aber auch nicht ber lesen Die Anweisung kann bei allen Werten von FUNKTION angegeben werden END Beendet die Folge der REPORT Anweisungen an den REPORT Generator FUNKTION Ausw hlen der Funktionen des REPORT Generators Mit FUNKTION werden die Funktionen des REPORT Generators ausgew hlt und zum Ablauf gebracht Die Anweisung kann mehrfach eingegeben werden wenn mehrere Funktionen ausgef hrt werden sollen Wenn die Anweisung nicht angegeben wird wird der Wert ALL angenommen FUNKTION ALL CREATE SORT PRINT FUNKTION ALL Die Funktionen CREATE SORT und PRINT werden ausgef hrt FUNKTIONZCREATE Eine Arbeitsdatei OUTPUT WORK FILE mit den erforderlichen Datens tzen aller Netze die ber de REPORT Anweisungen NET NAME und oder PERIOD NAME ausgew hlt wurden soll erstellt werden FUNKTION SORT Die Arbeitsdatei OUTPUT WORK FILE soll gem den Vorgaben ber die REPORT Anweisungen SORT STATE ORDER und SORT FIELDS ORDER sortiert werden FUNKTION PRINT Eine Liste aller mit den REPORT Anweisungen SELECT STATUS und THRESHOLD aus gew hlten Netze aus der zugeordneten Arbeitsdatei OUTPUT WORK FILE soll erstellt und in die zugeordnete Repo
521. rmittelt die Produktionsumgebung zum Zeitpunkt des Ausfalls Nach einem Ausfall des BS2000 OSD inklusive AVAS und den Agenten AVSSINCM f r die Server Jobs wird nach einem Neustart des AVAS automatisch f r Server Jobs die zum Zeitpunkt des Ausfalls im Status RUNNING waren eine Ergebnisabfrage QUERY angesto en Diese automatische Ergebnisabfrage f hrt die Ablaufsteuerung auch dann aus wenn sie mit CANCEL beendet wurde e BS2000 Jobs die zum Ausfallzeitpunkt im Status RUNNING waren sind mit aus gefallen und erhalten den Status ERROR e F r Server Jobs die zum Ausfallzeitpunkt im Status RUNNING waren wird der aktuelle Zustand ermittelt Server Jobs die in der Zwischenzeit beendet sind erhalten den Status ENDED oder ERROR Server Jobs die noch nicht beendet sind bleiben im Status RUNNING F r in der Zwischenzeit beendete Server Jobs werden die LOG Dateien erfasst e Server Jobs die gestartet werden sollten w hrend AVAS nicht verf gbar war werden entsprechend der Einstellung f r Versp tungen NET DELAY SOLUTION in der Netzbeschreibung behandelt 3 Ausfall der Kommunikation zwischen BS2000 OSD und dem AVAS Server F r einen fehlerfreien Produktionsablauf muss der AVAS Agent AVSSINCM BS2000 OSD mit dem AVAS Server kommunizieren k nnen e Der Server Job der im Server System weiterlaufen kann erh lt den Status ERROR und mit ihm auch das Jobnetz Nach einem RESTART NET wird nach Verf gbarkeit der Kommunika
522. rner Fehler beim Systemaufruf getenv auf weil die Umgebungsvariablen AvS SINJV bzw 2AVS SINJVZ Name der JV Datei im Server System und AVSSINJV bzw AVSSINJV Inhalt der JV Datei nicht defi niert sind 11 4 2 AVSLOG Zuordnung der Protokolldateinamen Mit dem Ablauf eines Server Jobs k nnen zwei Protokolldateien zum BS2000 OSD ber tragen werden Das Signalisieren der beiden Dateien geschieht mit dem Programm avslog Nachdem der Server die beiden Dateien zum BS2000 OSD bertragen hat k nnen sie auf dem Server bei Bedarf wahlweise gel scht werden Das Programm avslog exe liegt bei Windows Systemen im Verzeichnis AVAS_BINPATH auf UNIX Systemen im Verzeichnis bin unterhalb des Installationsverzeichnisses Das Signalisieren der Dateien ber die Parameter stdout und stderr erfolgt im UNIX und Windows System mit dem Aufruf des Programms avslog avslog stdout dateiname stderr lt dateiname gt avslog stdout lt dateiname gt stderr lt dateiname gt rmall avslog stdout lt dateiname gt avslog stdout dateiname rmout avslog stderr lt dateiname gt avslog stderr lt dateiname gt rmerr ber dateiname wird eine Datei angegeben die zum BS2000 OSD bertragen und in der AVAS Protokolldatei LOGSYS gespeichert werden soll Durch die Parameter rmout rmerr und rmall kann der Server dazu veranlasst werden die bertragenen Dateien zu l schen Bei Angabe des Parameters rmout wird die
523. rozedur AVS REORG AVS REORG ist ein Element J der Bibliothek SYSPRC AVAS 070 In der Reorganisationsprozedur muss ber die Parameter ZDD PASSWORD und ZDL PASSWORD das Kennwort angegeben werden das von den zentralen Zugriffsprozessen mit REO PASSWORD vorgegeben wurde siehe Seite 112 Wenn ZDD PASSWORD und REO PASSWORD bei ZDL oder ZDD PASSWORD und REO PASSWORD bei ZDD nicht bereinstimmen wird die Anmeldung an die zentralen Zugriffsprozesse abgewiesen Bei der Reorganisation werden die abgearbeiteten Netze aus der Ablaufdatei und Journal datei entfernt Die Journals tze werden gesichert und wenn ber den Parameter JOBLOG SAVE gefordert auch die Protokolleintr ge Das L schen der abgearbeiteten Netze und Jobs in den Produktionsdateien wird durch den Parameter DELETE PLAN NET erreicht und erfolgt bei der Reorganisation der Ablaufdatei Dies gilt jedoch nur f r Netze die ber SUBMIT NET oder REPEAT NET freigegeben wurden Wenn mit DELETE PLAN NET YES gearbeitet wird muss jedem Benutzerkreis mindes tens ein Benutzer zugeordnet sein Wenn das bei einem Benutzerkreis nicht der Fall ist kann die Funktion nur mit der Dialog BATCH Anweisung und mit Berechtigung des Funk tionsaus benden ausgef hrt werden Mit dem Parameter JOBLOG DELETE STATUS werden alle Protokolleintr ge mit dem angegebenen Status gel scht wenn es durch den Parameter DELETE JOB LOG YES verlangt wird Beim L schen von Netzen aus dem Produktionsplan und de
524. rozess wird durch den Aufruf der Prozedur AVS CENTRAL Element der Bibliothek SYSPRC AVAS 070 gestartet und zwar einmal als Prim rtask und mehrfach als Sekund rtask Die Anzahl kann ber den GENPAR Parameter MAX CENTRAL PROCESS eingestellt werden Beim Start des CENTRAL Prozesses wird von der Prozedur das SYSOUT Protokoll zuge wiesen auf die Dateien AVAS L OUT CNTPR yymmdd hhmmss f r Prim rtask und AVAS L OUT CNTSE yymmdd hhmmss f r Sekund rtask Wenn die SYSOUT Dateien nicht ben tigt werden m ssen sie explizit gel scht werden U21462 J Z125 7 141 Administrationsaufgaben im Betrieb Administration von AVAS Folgende Informationen zur Anmeldung bei der ZD und zum Ablauf werden als Parameter anweisungen ber SYSDTA gelesen APPLICATION name jobvariable name Name des CENTRAL Prozesses der Name dieser DCAM Anwen dung muss im BS2000 OSD eindeutig sein jobvariable Der Name der DCAM Anwendung CENTRAL steht ab Stelle 1 der angegebenen Jobvariablen AVAS SYSTEM ID string 7 Zeichen lange Zeichenkette Kennung die das AVAS System identifiziert Die AVAS Systemkennung muss angegeben werden DEFAULT TRANSFER OPTION ENDED ERROR NO Der Standardwert f r den Steuerungs Parameter TRANSFER OPTION bei der Funktion SIGNAL ist ENDED Er kann hier auf einen der oben angegebenen Werte ge ndert werden Die Bedeu tung ist bei der Funktion beschrieben DEFAULT DELETE YES NO Der Stan
525. rt automatisch gesetzt ist wird der Dienst mit dem Hochfahren des Systems automatisch wieder gestartet Das Beenden des Dienstes f hrt zum sofortigen Ende der Prozess berwachung U21462 J Z125 7 11 3 5 1 11 3 5 2 478 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs 11 3 5 3 Anzeigen und Andern der Ablaufparameter des Windows Dienstes AvasService Mit dem Programm AVAS Konfiguration konnen die Ablaufparameter des Windows Dienstes AvasService komfortabel angezeigt und ge ndert werden Das Programm AVAS Konfiguration wird im gleichen Verzeichnis wie der AVAS Server AVAS SV installiert Eine korrekte Installation von AVAS SV wird dabei vorausgesetzt Folgende Parameter k nnen angezeigt und ge ndert werden siehe auch Bild 9 Arbeitsverzeichnis Verzeichnis f r tempor re Dateien Portnummer Logische Portnummer des Dienstes Passwort Kommunikationskennwort Protokolldatei Name der Datei f r Ablaufinformationen Die ge nderten Werte werden beim n chsten Start des Windows Dienstes AvasService bernommen Der Installationspfad des Windows Dienstes AvasService wird ebenfalls angezeigt ber die Schaltfl che Benutzer gelangt man zum Fenster Benutzerverwaltung siehe Bild 10 auf Seite 480 mit dem Benutzerkennungen und ihre Kennw rter f r den Windows Dienst verwaltet werden k nnen 4 AVBS Konfiguration x AVAS SV 7 0300 AVAS Konfiguration 7 03 00 Installationsp
526. rt Beim L schen bzw Aktualisieren werden die Parameter NET NAME HISTORY DELETE DATE und HISTORY KEEP RECORDS ber cksichtigt Wenn nur die Datens tze NET gespeichert wurden HISTORY SAVE OPTION NET dann werden nur die Datens tze NET in der History Datei gel scht Die Datens tze SUM werden entsprechend aktualisiert JOB Die Datens tze JOB werden in der History Datei gel scht die Datens tze SUM werden entsprechend aktualisiert Beim L schen bzw Aktualisieren werden die Parameter NET NAME HISTORY DELETE DATE und HISTORY KEEP RECORDS ber cksichtigt Dabei werden die zugeordne ten Datens tze NET nicht gel scht Damit ist es m glich Datens tze NET ber einen l ngeren Zeitraum zu speichern als Datens tze JOB oder eine gr ere Anzahl von Datens tzen NET 174 U21462 J Z125 7 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien HISTORY KEEP RECORDS Die Reorganisationsanweisung bestimmt wie viele Datens tze von Netzen und von Jobs in der History Datei gespeichert werden Wenn mehr S tze eines Netzes oder Jobs vorhan den sind als die angegebene Anzahl dann sollen diese gel scht werden Gel scht werden die Datens tze der Netze deren PLAN START am weitesten in der Vergangenheit liegt HISTORY KEEP RECORDS nnn nnn 012 999 nnn Die Datens tze NET und JOB werden in der History Datei gel scht und die Datens tze SUM entsprechend aktualisiert wenn f r ein Netz oder einen Job mehr S tz
527. rt dass die AVAS Masken weiterhin erkannt werden und so ein problemloser Umstieg auch erfahrener AVAS Benutzer m glich ist 2 3 1 Hard und Software Voraussetzungen nderungen der hier beschriebenen Hard und Software Voraussetzungen entnehmen Sie bitte der Freigabemitteilung zu AVAS Hardware Voraussetzungen BS2000 0SD e System 7 500 PC e PC ab 386 SX empfohlen 486 SX mit 8 Mbyte Hauptspeicher empfohlen 486 SX mit 16 Mbyte Hauptspeicher mit 17 Monitor mit einer Aufl sung von 800x600 Punkten oder BS2000 Client PC MFT2 e Festplatte mit mindestens 16 Mbyte freiem Speicherplatz e BAM Karte D518 oder Ethernet Karte LAN1 oder andere von der verwendeten Emulation unterst tzte Karten U21462 J Z125 7 63 AVAS DOORS Installation und Generierung Software Voraussetzungen BS2000 OSD e BS2000 OSD BC ab V3 0 e AVAS V6 0 e FHS V7 1 PC e MS DOS ab V5 0 bei Windows 3 1 e Windows2000 Windows XP Windows Server 2003 inkl Unterst tzung des Microsoft Cluster Servers e LAN1 ab V2 0 bei Verwendung einer Ethernet Karte e FHS DOORS V3 0 e Emulation mit DDE Schnittstelle DOORS Mini Emulation und Communication Layer TRCOMMS sind im Lieferumfang von FHS DOORS enthalten e Programm zum bertragen von Dateien vom BS2000 OSD auf den PC z B FT PCD Installation von AVAS DOORS AVAS DOORS V7 0A wird auf der CD AVAS SERVER V7 0A ausgeliefert Da die AVAS DOORS Masken von FHS DOORS zur Aufbereitung d
528. rt JOB MAP definiert werden JOB MAP JCLSYS MAPmmm JCL001 MAPmmm JCL002 MAPmmm JCLnnn MAPmmm Die Zuordnung von MAP zu JCL kann ge ndert werden U21462 J Z125 7 32 Installation und Generierung Generierung des AVAS Systems Definition der Zuordnung der Maskenbibliotheken zu den Netzbibliotheken Mit dieser Zuordnung werden die Schl sselw rter der Bibliotheken verkn pft die f r die Netzmodifikation durch Benutzermasken ben tigt werden Dazu muss je einer Netzbiblio thek NETnnn je eine Maskenbibliothek MAPmmm zugeordnet werden Die Zuordnung muss mit dem Schl sselwort NET MAP definiert werden NET MAP NETSYS MAPmmm NET001 MAPmmm NETOO2 MAPmmm NETnnn MAPmmm Die Zuordnung von MAP zu NET kann geandert werden Definition der Funktionsberechtigungen Mit der Definition der Funktionsberechtigungen werden die Anweisungen f r die der Benutzer berechtigt ist und die Art der Berechtigung festgelegt Wenn die Berechtigungen eines Benutzers ge ndert werden sollen muss in der Definition des Benutzers siehe oben eine andere Funktionsberechtigungstabelle zugeordnet werden FUTABnnn FUTABnnnz funktion1 0 1 3 funktion2 0 1 funktion3 0 1 Nach dem Schl sselwort FUTABnnn sind in Klammern die zugelassenen Anweisungen funktion durch Komma getrennt anzugeben F r die Anweisungen die hier nicht angege ben werden gilt die Voreinstellung 0 F r die Anweisungen SIGNON
529. rtdatei OUTPUT REPORT FILE ausgegeben werden U21462 J Z125 7 290 REPORT Anweisungen NET NAME NET NAME Ausw hlen der Netze ber den Netznamen Mit NET NAME werden die Netze aus dem Produktionsplan ber den Netznamen ausge w hlt und in die Arbeitsdatei OUTPUT WORK FILE bertragen NET NAME OWN ALL x bk_ bk netname NET NAME OWN Die Netze des eigenen Benutzerkreises werden ausgew hlt NET NAME ALL Die Netze aller Benutzerkreise der zugeordneten NPRLIB werden ausgew hlt Die Eingabe ALL wird in umgesetzt NET NAME x Die Netze aller Benutzerkreise die mit dem angegebenen Zeichen beginnen werden aus gew hlt z B NET NAME T NET NAME bk Die Netze des angegebenen Benutzerkreises werden ausgew hlt NET NAME bk netname jjmmtt hhmmss Wenn ein vollqualifizierter Netzname angegeben wird wird nur dieses Netz ausgew hlt Wenn der Netzname teilqualifiziert angegeben wird letztes Zeichen werden alle Netze ausgew hlt deren Namen mit der Teilqualifizierung beginnen Der Benutzerkreis muss angegeben werden Die Menge der auszuw hlenden Netze kann durch die Anweisung PERIOD NAME weiter eingeschr nkt werden Wenn die Anweisung nicht angegeben wird wird DOWN angenommen Wenn die Auswertung f r eine vorgegebene Liste von Netznamen erfolgen soll kann FUNKTION CREATE mehrfach mit unterschiedlichen Netznamen aufgerufen werden Der REPORT Generator sammelt die Daten der
530. rte k nnen direkt beim Netz gespeichert oder die Speicherung abgebrochen werden Wenn keine weiteren Benutzereingriffe mehr notwendig sind kann auf die Dialogausgabe der Benutzermaske verzichtet werden Andernfalls wird die Benutzermaske mit den ber gebenen Werten ausgegeben Der Ausgang AVEX6601 wird aktiviert bevor eine zugeordnete Benutzermaske ausge geben wird Die RZ Routine kann die Eingaben f r die Benutzermaske zur Bearbeitung oder Ausgabe bergeben RZ Exit AVEX6602 bergabe der Werte der Maskenfelder einer Netzmaske Wenn JCL Anweisungen eines Jobs mit Hilfe einer im Netz vorgegebenen Benutzermaske Parameter OBJECT MAP der Anweisung CREATE NET DESC modifiziert werden sol len muss die Anweisung COLLECT NET PARAMS zum Erfassen der Eingaben f r die Be nutzermaske verwendet werden Am RZ Exit AVEX6602 werden die den AVAS Variablen N nnn zugeordneten aktuellen Werte aus der Benutzermaske der RZ Routine bergeben U21462 J Z125 7 71 RZ Exits im AVAS System Installation und Generierung Die Modifikation mit den bergebenen Werten kann direkt zugelassen abgebrochen oder mit einer Meldung abgewiesen werden Wenn die RZ Routine im Feld RETURNCODE einen Fehler zur ckmeldet wird im Feld MSG der Benutzermaske eine Fehlermeldung aus gegeben Der Ausgang AVEX6602 wird aktiviert bevor die Werte der AVAS Variablen N nnn gespei chert werden CMD CONTINUE in der Benutzermaske Der RZ Routine werden die Eingaben a
531. rtragung dieses Protokolls ist keine Vorausset zung f r das normale Ende des Jobs im AVAS System Der Jobstatus ist vom Ergebnis der Protokoll bertragung nicht betroffen ERROR Die Ablaufsteuerung startet zur bertragung dieses Protokolls einen Folgejob wenn im Job kein Aufruf TRANSFER enthalten ist Die fehlerfreie bertragung dieses Protokolls ist Voraussetzung f r das normale Ende des Jobs im AVAS System Wenn das Protokoll nicht bertragen werden konnte f hrt dies zum Jobstatus ERROR In diesem Fall ist f r das Netz den Job ein Restart einzuleiten NO Die Ablaufsteuerung startet keinen Folgejob zur bertragung die ses Protokolls Wenn im Jobablauf die Protokoll bertragung vorgenommen wird muss der Benutzer durch Auswerten des R ckkehrcodes im Job das normale oder abnormale Ende des Jobs selbst setzen und damit auch den Status des Jobs im AVAS System Hinweise Wenn der Parameter TRANSFER OPTION nicht vorgegeben wird wird der beim Start von CENTRAL angegebene Wert angenommen Die Ablaufsteuerung startet keinen Folgejob f r Protokolle deren bertragung im Job versucht und wegen eines Fehlers nicht durchgef hrt wurde 146 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb Wenn die bertragung eines Protokolls wegen eines Fehlers abgebrochen wurde werden die bis dahin bertragenen Daten nicht gespeichert Dem signalisierten Protokoll ist im Inhaltsverzeichnis der Proto
532. rung ohne den Startparameter SERVER JV LINK gestartet wird ist bei der Server berwachung der Name der Ablaufsteuerung anzugeben siehe auch Seite 119 Hinweis Die Ablaufsteuerung pr ft vor dem Starten eines Serverjobs ber die Server Jobvariablen ob der Server aktiv ist Deshalb muss ihr der Link Name mitgeteilt werden Dies geschieht ber den Start parameter SERVER JV LINK der Ablaufsteuerung Die Namen m ssen bei Server berwachung und Ablaufsteuerung identisch sein list poss 16 lt file name 1 54 gt NONE Namen der kontrollierenden Jobvariablen der Ablaufsteuerung Vorgabewert NONE lt integer 1025 65535 NONE TCP Port unter dem AVSSVDOG von AVSSURF kontaktiert wer den kann Vorgabewert NONE integer 1 60 lt Wartezeit in Sekunden auf Antwort des Servers bei der ersten Kontaktaufnahme Start des AVSSVDOG Die Wartezeit gilt f r jeden einzelnen Kommunikationsschritt Vorgabewert 1 Sekunde integer 1 60 lt Wartezeit in Sekunden auf Antwort des Servers bei Server Kon taktierungen nach der ersten Kontaktaufnahme Vorgabewert 10 Sekunden Administration von AVAS SERVER JV LINK RCS JV PORT INITIAL TIMEOUT TIMEOUT Der Prozess Server berwachung wird mit der Prozedur AVS SVDOG gestartet Die Proze dur ist ein Element J der Bibliothek SYSPRC AVAS 070 125 U21462 J Z125 7 Starten und Beenden der AVAS Prozesse Administration von AVAS Hinweise e Beim Starten des AV
533. s AVSCOBCD COPY AVSCOBCD AVSCOBCD 002 941006 47105173 AVAS U COPYRIGHT C FUJITSU SIEMENS COMPUTERS GMBH 2000 ALL RIGHTS RESERVED ABLDAT CONDITION DIRECTORY DESCRIPTION 07 AVSICDIR 10 AVSIFCNM 15 AVSICTYS PICTURE X 3 15 AVSICNAM PICTURE X 30 15 AVSICNNM PICTURE X 32 15 AVSICIND PICTURE 9 3 10 AVSICTYP PICTURE X 10 AVSICSTI PICTURE X 10 AVSICLTI 15 AVSICLTD PICTURE X 6 15 AVSICLTT PICTURE X 6 10 FILLER PICTURE X 14 RER END OF COPY ELEMENT AVSCOBCD EAN U21462 J Z125 7 433 Cobol Schnittstelle Programmschnittstelle von AVAS AVSCOBCE Bedingungseintrag in der Ablaufdatei definieren Das COPY Element AVSCOBCE definiert die Beschreibung eines Bedingungseintrags Aufruf COPY AVSCOBCE Aufl sung des COPY Elements AVSCOBCE COPY AVSCOBCE AVSCOBCE 002 941006 47105174 AVAS U
534. s BS2000 Kommando SET FILE LINK definiert werden Wenn weder die Anweisung OUTPUT REPORT FILE noch die Anweisung OUTPUT REPORT LINK angegeben wird dann wird gesetzt OUT OF PLAN OUTPUT REPORT FILE LST AVAS OOP jjmmtt hhmmss PLANNED NET MODIFICATION OUTPUT REPORT FILEZLST AVAS PNM jjmmtt hhmmss U21462 J Z125 7 293 OUTPUT WORK FILE REPORT Anweisungen OUTPUT WORK FILE Zuordnen BS2000 Dateiname f r Arbeitsdatei Mit OUTPUT WORK FILE wird der Arbeitsdatei ein BS2000 Dateiname zugeordnet Die Arbeitsdatei ist e die Ausgabedatei bei FUNKTION CREATE e die Ein Ausgabedatei bei FUNKTION SORT e die Eingabedatei bei FUNKTION PRINT Die Arbeitsdatei muss bei allen Funktionen angegeben werden OUTPUT WORK FILE full filename Dateiname gem den BS2000 Konventionen Die ber die Anweisung OUTPUT WORK FILE zugeordnete Arbeitsdatei wird vom REPORT Generator im Modus OUTPUTZEXTEND er ffnet wenn sie bereits vorhanden ist Der REPORT Generator sammelt die Daten der Netze in der angegebenen Arbeitsdatei wenn FUNKTION CREATE mehrfach mit der gleichen Dateizuweisung aufgerufen wird Wenn eine neue Arbeitsdatei angelegt werden soll muss eine u U vorhandene Arbeits datei vorher gel scht werden Alternativ kann die Anweisung OUTPUT WORK LINK vorgegeben werden 294 U21462 J Z125 7 REPORT Anweisungen OUTPUT WORK LINK OUTPUT WORK LINK Zuordnen einer Arbeitsdatei ber Kettungsname Der Arbeitsdatei wird mit O
535. s werden nicht berpr ft Sie erscheinen auch nicht in den von MARENAV erstellten Datentr gerlisten 6 3 5 Beispiel f r die Weiterverarbeitung einer VSN in einem Netz Eine Banddatei wird innerhalb eines Netzes zweimal verarbeitet Im ersten Job wird sie als Ausgabedatei erstellt und in einem der nachfolgenden Jobs als Eingabedatei verwendet Ohne den Einsatz von MARENAV sind jedes Mal vor dem Starten des Netzes folgende Aktionen durchzuf hren e B nder mit MARENADM oder anderen Archivierungsprogrammen reservieren e VSNs der neu reservierten B nder in die ENTER Datei en eintragen Durch den Einsatz von MARENAV k nnen diese beiden Vorarbeiten entfallen Wenn bereits beim Erstellen der ENTER Dateien die Parameter VOLUME SCR n bzw VOLUME VOL in die Dateizuweisungen eingetragen werden sind keine Vorarbeiten vor dem Starten des Produktionslaufs mehr notwendig U21462 J Z125 7 273 Erstellen von Datentr gerlisten Kopplung AVAS mit MAREN 6 3 6 Hinweise zu Wiederholungsl ufen Bei den zwei verschiedenen Arten von Wiederholungsl ufen ber die AVAS Anweisungen RESTART NET und REPEAT NET sind in Bezug auf MARENAV einige Besonderheiten zu bedenken 1 Wiederanlauf eines unterbrochenen Netzes ber RESTART NET Wenn im Rahmen des RESTART Laufs B nder angefordert werden die vor Abbruch des Jobs bzw Netzes bereits verarbeitet wurden ist vor dem Wiederanstarten in Bezug auf das MAREN System sicherzustellen dass alle im
536. se goto Exit ERRORLEVEL ExitO rem Job OK beendet set ERGEBNIS JOB OK BEENDET goto Ende Exitl rem Job wurde abgebrochen set ERGEBNIS RV 0 JOB ABGEBROCHEN goto Ende Exit2 rem Fehler vor Start des R 3 Jobs set ERGEBNIS RV 0 JOB NOCH NICHT GESTARTET goto Ende Exit3 rem Fehler nach Start des R 3 Jobs set ERGEBNIS RV 0 JOB SCHON GESTARTET Ende AVASBIN avssinjv exe ERGEBNIS AVASBIN avslog exe stdout ZAVASR3LOGFILEZ USER PAR FILE Datei BS2_EXT_PRI par job BS2NTEXTPRI programl 1s parameterl x typl extern hostl helios program2 RSPFPAR variant2 GW program3 pwd typ3 extern pridest LPOl pricopies 1 pri imm Y 512 U21462 J Z125 7 Steuerung von SAP R 3 Jobs mit AVAS Text 516 Job wurde gestartet 611 Step 001 gestartet 612 Externes Programm 5 613 Zugeh Parameter X 606 Ext Prog ENQLOGOO 606 Ext Prog stderr2 606 Ext Prog stdoutl 606 Ext Prog stdout4 550 Step 002 gestartet Programm e GW Benutzername EICH 611 Step 003 gestartet 612 Externes Programm pwd 613 Zugeh Parameter 606 Ext Prog 607 Job wurde beendet 513 AVAS SV Plattform bergreifende Jobsteuerung LOG Datei BS2NTEXTPRI 1og 1 0 MsgId No BT B BT BT BT stderr4 BT stdout3 BT 00 d BT BT BT BMGSO1 work BT version g Time 06 095725 06 095725 06 095725 06 095726 06 095726 06 095726 2 06 095726 06 095726 R Variant 06
537. sibility avuser Identifikation des Benutzers maximal 8 Zeichen password Kennwort des Benutzers maximal 8 Zeichen bk Name des Benutzerkreises dem der Benutzer zugeordnet ist dem Systembenutzerkreis kann kein Benutzer zugeordnet werden FUTABnnn Schl sselwort einer Funktionsberechtigungstabelle break YES Unterbrechen durch die K2 Taste ist zugelassen NO Unterbrechen ist nicht zugelassen Standardeinstellung Hinweis Das Unterbrechen des Dialogbetriebs ber die K2 Taste ist in jedem Fall erst nach einer erfolgreichen Anmeldung m glich Nach Eingabe der An weisungen SIGNON und END ist ein Unterbrechen nicht mehr m glich password visibility YES Das BS2000 Kennwort kann auf den entsprechenden Masken sichtbar ausgegeben werden NO Das BS2000 Kennwort ist in jedem Fall dunkel gesteuert 30 U21462 J Z125 7 Installation und Generierung Generierung des AVAS Systems USER avuser password Definition weiterer Benutzer Die Definition mit dem Schl sselwort USER ist so oft anzugeben wie Benutzer im Benut zerkreis zugelassen werden Die in Klammern anzugebenden Werte m ssen in der oben beschriebenen Reihenfolge geordnet sein Stellungs Parameter Die Zuordnung von password bk und FUTABnnn zu den Benutzern kann im laufenden AVAS Betrieb durch die Anweisung MODIFY SYSTEM PARAMS ge ndert werden Ein Benutzer kann sein Kennwort in der SIGNON Maske auch dann ndern wenn er keine Berechtigung f r MODIFY SYSTEM PA
538. sie werden in den ersten 8 Spalten der lt server name gt wie derholt und statt des Leerzeichens ein Folgekennzeichen angegeben Dieses Zeichen legt die Reihenfolge der Folgezeilen fest Sie werden nach Entfernung des 9 Byte langen Schl ssels unmittelbar an die vorausgehenden Zeilen angef gt Dieser Mechanismus kann auch verwendet werden um jeden Bereich ab lt hostname portnr gt in eine eigene Zeile zu schreiben Wenn zwischen dem Start und Restart eines Jobs dessen lt server name gt Eintrag ge n dert wird kann es sein dass AVSSINCM beim Restart den Status des Server Jobs nicht mehr ermitteln kann z B nachdem der Hostname des Server Systems oder die Userid ge ndert wurde AVSSINCM lehnt dann den Restart mit TYPE RESTART ab f hrt aber den Restart mit TYPE NORMAL aus wenn der Server Job bereits gestartet ist U21462 J Z125 7 461 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung Beispiel f r einen Eintrag in einer Konfigurationsdatei 30 00 UNIX2 UNIX2PW 31 00 UNIX2 1 123 22 84 456 7777 32 00 UNIX2 2 avas 33 00 UNIX2 3 PASSWCOM home avas test home avas work alternati ve Darstellung des gleichen Eintrags 30 00 UNIX2 UNIX2PW 123 22 84 456 7777 avas PASSWCOM test work In der obigen Zeile wurden die Pfade durch abgek rzt um eine bersichtlichere Darstel lung zu erreichen Parameterzuordnung server name UNIX2 server pw UNIX2PW hostname
539. sind und welche R ckgabeinformationen zur Auswertung bereitstehen Zur leichteren Handhabung sind die symbolischen Namen dort in Klammern beschrieben F r die Programmierung sind in dem Makro bzw im COPY Element weitere Einzelheiten durch Definitionen beschrieben die sich insbesondere mit Feldern ergeben in denen Verschl sselungen verwendet werden z B AVSCMDC AVSRFDBK Die Anweisung SIGNON ist die erste Anweisung die an die AVAS Programmschnittstelle zu richten ist Als letzte Anweisung muss END gegeben werden um eine normale Abmeldung der Verar beitung gegen ber den ZDs durchzuf hren Wenn dies nicht erfolgt wird erst bei Pro grammende bzw Prozessende eine zwangsweise Abmeldung bei den ZDs durchgef hrt U21462 J Z125 7 381 Programmschnittstelle von AVAS Hinweis AVAS teilt dem Betriebssystem mit dass bei einer Beendigung des Programmlaufs dies ist auch bei Prozessende der Fall eine AVAS Routine zu aktivieren ist Wenn das Benutzerprogramm mit Assemblermakro STXIT diese Verbindung durch eigene Aufrufe zerst rt oder ver ndert ist eine fehlerfreie Abmeldung bei den ZDs nicht gew hrleistet Dies kann dazu f hren dass bei den ZDs eine Anmeldung bestehen bleibt zu der es keinen Benutzer mehr gibt Das kann wiederum bewirken dass die Anzahl der zugelassenen BATCH Benutzer bei den ZDs eingeschr nkt oder auf Null reduziert wird Ergebnisbereich OUTAREA Im Ergebnisbereich erh lt das Benutzerprogramm die Result
540. sortiert werden sollen Die Anweisung wird nur beim OUT OF PLAN Report verarbeitet Die Anweisung muss nur bei FUNKTION SORT angegeben werden SORT STATE ORDER liste status Liste von Status Werten nach denen die Netze sortiert werden sollen Hier ist der globale Status anzugeben siehe GLOBAL STATE Seite 305 ERROR Netze im Status ERROR NO SUBMIT Netze die nicht zur Verarbeitung freigegeben wurden WAITING Netze die freigegeben aber noch nicht gestartet wurden STARTED Netze die gestartet und noch nicht beendet wurden Ausgenom men sind die Netze im Status ERROR die dort angezeigt werden ENDED Netze die sich normal beendet haben ABENDED Netze die sich abnormal beendet haben Wenn die Anweisung nicht angegeben wird wird in der intern festgelegten Reihenfolge sor tiert SORT STATE ORDER ERROR NO SUBMIT WAITING STARTED ENDED ABENDED Wenn nur einige Status Werte angegeben werden werden die weiteren Werte in der intern festgelegten Reihenfolge angeh ngt U21462 J Z125 7 299 SYSTEM PASSWORD REPORT Anweisungen SYSTEM PASSWORD Anmelden beim zentralen Zugriffsprozess Das Kennwort des AVAS Systems wird zur Anmeldung beim zentralen Zugriffsprozess ZDD ben tigt Der REPORT Generator ben tigt zur Anmeldung beim ZDD das beim Start des ZDD Pro zesses mitgegebene Kennwort REOPW kennwort Die Anweisung muss nur bei FUNKTIONZCREATE angegeben werden SYSTEM PASSWORD STD password SYSTEM PASSWORD STD
541. sse auf Seite 22 Die Ablaufsteuerung RUN CONTROL SYSTEM wird mit folgender Prozedur gestartet AVS AVAK Die Prozedur ist ein Element J der Bibliothek SYSPRC AVAS 070 Starten der Ablaufsteuerung Zum Ablauf ben tigt die Ablaufsteuerung ber SYSDTA folgende Eingaben die auf Anfor derung eingegeben werden m ssen SYSID kennung AVAS SYSTEM ID des Systems Die AVAS Systemkennung muss angegeben werden AVAK name Name einer Ablaufsteuerung Der Name muss in den System Parametern als Ablaufsteuerung RUN CONTROL SYSTEM definiert worden sein Die Ablaufdatei und die Journaldatei m ssen f r diese Ablaufsteu erung formatiert sein Der Name der Ablaufsteuerung muss angegeben werden END Ende der Startparameter Die Anweisungen SYSID AVAK und END sind obligatorisch U21462 J Z125 7 113 Starten und Beenden der AVAS Prozesse Administration von AVAS Die Auftrags Jobvariablen werden ohne Kennwort eingerichtet NONE ist in der Startprozedur als Standardwert vorgegeben Das Kennwort f r die Auftrags Jobvariablen vergibt die Ablauf steuerung Das Kennwort ist in einer L nge von 4 Zeichen alphanumerisch oder sedezimal anzugeben Alle Auftrags Jobvariablen werden mit diesem Kennwort eingerichtet MONJV PASSWORD NONE STD Hinweis F r einen erneuten Start der Ablaufsteuerung ist das gleiche Kennwort zu verwenden das bei ihrem ersten Start vergeben wurde Nur wenn alle Netze beendet sind kann ein erneuter S
542. ssel 56 ORG N3INH S56 AVASJRN S56 SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 6 u ERSETZT SATZSCHLUESSEL 64 AB VERSION 02 0A 5 5565568 DS 0C SATZBESCHREIBUNG SATZ 56 S56TYPT DS 0CL3 YPE EXT S56TYP DS X TYPE CODE DS CL2 DS CL3 RESERVIERT S56JSYN DS CL3 SYNC INDEX S56JENTT DS 0CL5 ENTER PARAMS NET LOGON TEXT S56JENT DS X ENTER PARAMS NET LOGON CODE DS CLA S56JUSR DS CL8 JOB USER S56JACC DS CL8 JOB ACCOUNT S56JCLA DS CL8 JOB CLASS S56JLGM DS CL8 JOB LOG S56JCAT DS CLA JOB CAT S56JPAR DS CL128 JOB PARAMETER S56JFIL DS CL54 ENTER SERVER FILE NAME DS CL2 RESERVIERT S56SXID DS CL8 SERVER PA NAME S56S56L EQU S56856A LAENGE DER DATEN S56LEN EQU N3JRNS U21462 J Z125 7 210 Sicherung und Reorganisation Datenstrukturen Journalsicherung Not Journaldatei Definitionen Satzschl ssel 57 ORG N3INH 57 AVASJRN S57
543. sselwort BKSYS definieren 27 558 Stichw rter zentrale Zugriffsprozesse 18 beenden 112 definieren 22 starten 107 Zugriffe auf Ablaufdatei 53 auf Bibliotheken 53 auf Dateien 53 auf Journaldatei 53 auf Not Journaldatei 53 auf Periodendatei 53 Zugriffsprozesse abnormale Beendigung 112 Zugriffsprozesse ZDs 53 abnormale Beendigung 112 beenden 112 128 normale Beendigung 112 starten 107 verz gerte beenden 112 zentrale 18 Zuordnung Maskenbibliotheken zu Jobbibliotheken Definition 32 Maskenbibliotheken zu Netzbibliotheken Definition 33 Netzbibliotheken zu Produktionspl nen Definition 32 RZ Exits 68 RZ Routinen in AVAS einbinden 74 559 USERID 465 USERID Startparameter f r AVSSINCM 5 USER PARAM FILE 8 USER PASSWORD Reorganisationsanweisung 180 V variable Periode Ersatzzeichen 0 erstellen 0 reale Daten 323 Verhalten im Fehlerfall 514 Verlagerungsprozedur MARENAV 272 Verschl sselung 21 Kennw rter 19 Versionswechsel 58 Verst ndigungsbereich Aufbau 380 RZ Routinen 78 verwalten Benutzer 127 135 Systembibliotheken 135 Systemparameterdatei 135 Voraussetzungen Hardware AVAS DOORS 63 Software AVAS DOORS 64 VSNs bei Ausgabeb ndern eintragen 5 bei Eingabeb ndern eintragen 3 in einem Netz Weiterverarbeitung 3 in eintragen 3 Warteschlange der BATCH Prozesse 8 Windows UNIX Server Ablaufsteuerung 1 Windows Benutzerverwaltung 0 Windows Dienst AvasService 8 2 ZDD PA
544. ssen Alle Datenfelder die mit TEXT und CODE definiert sind enthalten bereits die umgesetzten Texte Definitionen Satzschl ssel 11 S11 AVASJRN S11 SATZBESCHREIBUNG JOURNALSATZ SATZSCHLUESSEL 11 x khe he he he kk he ke hk eek 5115118 DS 0C SATZBESCHREIBUNG SATZ 11 S11SYMD DS CL20 SYMDAT SI1STUR DS CL1 SELECT TURNUS S11EARL DS CL12 EARLIEST START 511415 DS CL7 LATEST START SIIRUCS DS CL8 RUN CONT SYS SIINTXT DS CL120 NET TEXT 511100511 DS 0CL6 NET DELAY SOLUTION TEXT S11NDSL DS X NET DELAY SOLUTION CODE DS CL5 SI1LIFT DS CL7 NET LIFE TIME COND NET SIISPLT DS CLA SELECT PLAN TYPECNWRK WORK SIICALN DS CL20 CALENDAR NAME S11S11L EQU S11S811A LAENGE DER DATEN Definitionen Satzschl ssel 12 ORG N3INH S12 AVASJRN S12
545. st kein Cobol COPY Element vorgesehen Hinweis Wenn die Anweisung READ AVAS LIBRARY in einem Statusmonitor zur Ausgabe der aktuellen Journale verwendet wird sollte der Monitor von Zeit zu Zeit in die Jobvariable der UPAM ZD IN JRLDAT schreiben um eventuelle Not Journale in die Journaldatei einzumischen 379 U21462 J Z125 7 Aufbau der Verst ndigungsbereiche Programmschnittstelle von AVAS 10 2 Aufbau der Verst ndigungsbereiche Der Informationsaustausch an der AVAS Programmschnittstelle erfolgt ber drei Bereiche e den Kommunikationsbereich COMAREA e den Ergebnisbereich OUTAREA e den Arbeitsbereich WRKAREA Kommunikationsbereich COMAREA Der Kommunikationsbereich beschreibt alle Parameter die f r eine Anweisung erforderlich sind sowie die zur Auswertung notwendigen R ckgabeinformationen der AVAS Bearbei tung Die Definitionen dieses Bereiches sind im Makro AVSASSBC siehe Seite 400 bzw im COPY Element AVSCOBBC siehe Seite 427 festgelegt Im Einzelnen werden die Informationen ber folgende symbolische Namen ausgetauscht AVSCASID Parameter AVAS SYSTEM ID AVSCAUID Parameter AVAS USER ID AVSCAUPW Parameter PASSWORD AVSCCDNM Parameter CONDITION NAME AVSCCDNT Parameter CONDITION TYPE AVSCCDNN Parameter CREATED BY NET AVSCCDNI Parameter CREATED BY INDEX AVSCCDVL Parameter CONDITION VALUE AVSCEAS Parameter EARLIEST START NEW PLAN START Datum und Uhrzeit AVSCERIN
546. st zu beachten dass nur die REPORT Anweisungen verarbeitet wurden die den ausgef hrten Funktionen zugeordnet wurden Die nicht verarbeiteten Anweisungen m ssen nicht dem Inhalt der Arbeitsdatei oder den ausgef hrten Sortierbegriffen entsprechen Folgende Anweisungen werden bei den einzelnen Funktionen verarbeitet FUNKTION REPORT Anweisungen CREATE SORT PRINT AVAS SYSTEM ID ja nein nein SYSTEM PASSWORD ja nein nein AVAS USER ID ja nein nein USER PASSWORD ja nein nein NET NAME ja nein nein PERIOD NAME ja nein nein OUTPUT WORK FILE ja ja ja SORT STATE ORDER nein ja nein SORT FIELDS ORDER nein ja nein SELECT STATUS nein nein ja THRESHOLD nein nein ja OUTPUT REPORT FILE nein nein ja END ja ja ja U21462 J Z125 7 283 AVAS Reports JRNDAT Journale der Netze U21462 J Z125 7 NPRLIB Verzeichnis der geplanten Netze Arbeitsdatei gt Journal aller Netze l Reportdatei ausgew hlte Netze REPORT Generator 7 1 REPORT Generator Ablauf des REPORT Generators SYSDTA i REPORT Generator CREATE u SC mn SORT PRINT Bild 5 Ablauf des REPORT Generators 284 AVAS Reports REPORT Generator 7 1 1 Eingabe der REPORT Anweisungen f r den REPORT Generator Die Anweisungen f r den
547. status bei Anweisungen Anweisung LOGSYS Bemerkungen Funktion Status alt Status neu AVAK CREATED Die Ablaufsteuerung hat einen Protokolleintrag angelegt SIGNAL ASSIGNED Im Jobablauf wurde durch SIGNAL ein Protokoll signalisiert TRANSFER ASSIGNED TRANSFERRED Im Jobablauf wurde das Protokoll gesammelt ASSIGNED ERROR Im Jobablauf konnte das Protokoll nicht gesammelt werden Es trat ein Fehler auf ADD JOB LOG CREATED ADDED Ein erstes Protokoll wurde zu diesem Jobablauf hinzugef gt IGNORE Zu diesem Protokolleintrag sollen keine Protokolldaten hinzugef gt werden ASSIGNED ADDED Ein signalisiertes Protokoll wurde hinzu gef gt IGNORE Ein signalisiertes Protokoll ist nicht mehr relevant ERROR ADDED Ein signalisiertes Protokoll das im Job ablauf nicht gesammelt werden konnte wurde hinzugef gt IGNORE Ein signalisiertes Protokoll ist nicht mehr relevant ADDED ADDED Ein neues oder weiteres Protokoll wurde hinzugef gt DELETE JOB LOG ADDED Das oder die Protokolle eines Job ASSIGNED ablaufs wurden gel scht Es ist keine CREATED weitere Protokollbearbeitung f r diesen ERROR Jobablauf m glich IGNORE SAVED TRANSFERRED 154 U21462 J Z125 7 Administration von AVAS Administrationsaufgaben im Betrieb 3 3 5 Systemoptimierung Wenn sich beim Einsatz von AVAS Probleme ergeben bez glich des Durchsatzes bei der Ablaufdurchf hrung ode
548. steil der Netze in der NPRLIB und kann dann nicht mehr ver ndert wer den Die nderung der vorgesehenen Start Zeit nach dem Planungsvorgang erfolgt ber EARLIEST START Planungsintervall Zeitraum f r den der Ablauf ausgew hlter Netze geplant wird Vorgabe erfolgt durch PERIOD NAME Es kommen die Netze zur Bearbeitung deren symbo lische Starttermine in dem Kalenderausschnitt eingetragen sind der dem Planungsintervall entspricht U21462 J Z125 7 535 Fachworter Produktionsplan Inhaltsverzeichnis der Bibliothek der geplanten Netze Liste der geplanten Netze mit jeweiliger aufgel ster Startzeit und Produktionsstatus REPORT Generator Prozess zum Erstellen der AVAS Reports REPORT Anweisungen Anweisungen an den REPORT Generator Restart Anweisung In die JCL eingearbeitete Vorkehrungen f r den Wiederanlauf nach Fehler RESTART INDEX Indexstufe auf der im Restart Fall wiederaufgesetzt werden soll Restart Job Job der im Falle eines Verarbeitungsabbruchs zus tzlich ausgef hrt werden muss bevor die Normalverarbeitung fortgesetzt werden kann RESTART NAME Name des Strukturelements auf das im Restart Fall aufgesetzt werden soll RESTART NET Wiederaufsetzen eines vorher abgebrochenen Netzes RESTART VARIANT Angabe welche der drei m glichen Restart Varianten verarbeitet werden soll Beschreibung der drei Restart Varianten bestehend aus RESTART TYPE RESTART INDEX RESTART NAME RESTART TYPE Angabe o
549. stellen von AVAS Bibliothekselementen FILE PASSWORD Kennwort f r ENTER FILE U21462 J Z125 7 529 Fachworter FORMAT NAME Name einer Benutzermaske FUNCTION auch FU oder F Funktion eines Strukturelementes in der Netzbeschreibung FUNCTION kann folgende Werte annehmen J Job Beschreibung f r die Ausf hrung eines Jobs P Prozedur Beschreibung f r die Ausf hrung einer S Prozedur X SV Job Beschreibung f r die Ausf hrung eines Auftrags auf einem Server Rechner S Start Beschreibung f r das Starten eines Subnetzes A Add Erzeugen eines Bedingungseintrages M Modify ndern eines Bedingungseintrages D Delete L schen eines Bedingungseintrages C Compare Abfrage eines Bedingungseintrages W Wait Warten auf Datum und Uhrzeit Hypernetz Ein Hypernetz ist ein Netz mit Strukturelementen der Auspr gung FU S In ihm k nnen Subnetze zum Ablauf gebracht und berwacht werden Indexstufe Hierarchieebene der Netzstruktur Die Strukturelemente einer Indexstufe wer den gleichzeitig bearbeitet oder zum Ablauf gebracht Die Indexstufen werden nacheinander in aufsteigender Reihenfolge bearbeitet wenn die Indexstufe ordnungsgem beendet wurde Bei Fehlern wird die Verarbeitung jeweils am Ende einer Indexstufe unterbrochen Die Reihenfolge bzw das Warten auf eine Indexstufe kann durch die Angabe von Synchronisationsindex SYNC INDEX durchbrochen werden JCL Baustein ausgelagerte JCL eines oder mehrerer Jobs
550. stem ablief und anschlie end nicht die notwendigen Aktualisierungen im MAREN Katalog vorgenommen wurden Sofern Eintr ge aus dem Dateikatalog TSOSCAT zur berpr fung verwendet werden wird immer davon ausgegangen dass der aktuelle Katalogeintrag in unver nderter Form auch zum Ablaufzeitpunkt des Netzes existiert Wenn folglich in einem Systemkatalogein trag einer Datei eine VSN eingetragen ist die im MAREN Katalog nicht enthalten ist und der MAREN Parameter FOREIGN TAPE CHECK auf YES gesetzt ist wird die Produk tionsfreigabe abgebrochen Der Katalogeintrag einer Datei wird nicht ausgewertet wenn e derEintrag mit dem DVS Kommando IMPORT FILE erstellt wurde Datei von privatem Datentr ger e im DVS Kommando SET FILE LINK der Parameter VOLUME LIST verwendet wurde e inder Dateizuweisung beim Parameter VOLUME eine der Variablen VOL oder SCR angegeben wurde e die Datei bereits einmal im Netz angesprochen wurde Dabei kann sie beschrieben worden sein und ein eventuell zum SUBMIT Zeitpunkt bestehender Katalogeintrag ist dann zum Ablaufzeitpunkt nicht mehr aktuell Wenn ein Datentr ger zwar im Dateikatalogeintrag enthalten jedoch nicht beschrieben ist bei SHOW FILE ATTRIBUTES erscheint die VSN in Klammern wird dies in den Daten tr gerlisten vermerkt Vor dem Lesen des Dateikatalogeintrags wird der angegebene Dateiname auf das Vorhan densein einer CATID berpr ft Wenn eine Katalogkennung angegeben wurde wird d
551. stration von AVAS 3 1 2 Startparameter f r den Dialogprozess Der AVAS Administrator kann die Anmeldeinformation f r die AVAS Dialogbenutzer in einer Jobvariablen bereitstellen Diese gibt er dem Dialogsystem mit dem LINK Namen AVSUSER bekannt Anmeldeinformationen Nach dem Start der Dialogprozedur versucht AVAS die Anmeldeinformationen aus der Jobvariablen mit dem LINK Namen AVSUSER zu lesen Die Anmeldung erfolgt wenn in der Jobvariablen folgende Informationen gefunden werden Stellen 1 8 AVAS USER ID Stellen 11 18 USER PASSWORD Stellen 21 27 AVAS SYSTEM ID Bei erfolgreicher Anmeldung erscheint die Maske AVS020 anderenfalls wird das System mit einer Fehlermeldung beendet Der so angemeldete Benutzer kann nicht ber den Aufruf der Funktion SIGNON in eine andere Kennung wechseln Sein Kennwort kann er nur ndern wenn er die Berechtigung f r MODIFY SYSTEM PARAMS hat da er keine SIGNON Maske AVS010 erh lt Duch das Anmelden ber Jobvariable ist es m glich LOGON Prozeduren zu schreiben die dem Benutzer nichts anderes gestatten als sich in seiner BS2000 Sitzung unter einer vor gegebenen Kennung bei AVAS anzumelden und in AVAS zu arbeiten Der Wechsel in andere AVAS Kennungen oder andere Benutzerprogramme kann ihm so verwehrt werden Zu beachten ist dass AVAS eingegebene Kleinbuchstaben nicht in GroBbuchstaben um setzt und deshalb eine Anmeldung als fehlerhaft abgewiesen werden kann Wenn die Anmelde Parameter nicht
552. sung bestimmt welche Datens tze in der History Datei bei der Funktion SJOUR gespeichert werden sollen Es werden nur Datens tze von Netzen gespeichert die auch gesichert wurden HISTORY SAVE OPTION NO STD NET NO Es werden keine Datens tze in der History Datei gespeichert STD Die Datens tze NET und JOB werden in der History Datei gespeichert Die Datens tze SUM werden entsprechend aktualisiert NET Die Datens tze NET KEY 03 werden in der History Datei gespeichert Die zugeordneten Datens tze SUM KEY 01 werden entsprechend aktu alisiert Die Datens tze JOB KEY 04 werden nicht gespeichert Die zugeordne ten Datens tze SUM KEY 02 werden nicht aktualisiert Es wird empfohlen bei allen Reorganisationsl ufen dieselbe Wertzuweisung zu verwen den da sonst keine aussagekr ftigen History Daten zur Verf gung stehen F r die Operation 52 HISTORY bei der Anweisung NET CONTROL werden die Daten S tze SUM ben tigt JOBLOG DELETE DATE Die Reorganisationsanweisung legt fest dass alle Protokolle die bis zu einem bestimmten Tag oder innerhalb des angegebenen Zeitraums erstellt wurden aus der LOGSYS Biblio thek gel scht werden sollen Die Anweisung darf nur gegeben werden wenn zus tzlich DELETE JOB LOG YES ange geben ist JOBLOG DELETE DATE f period tt mm jj tt mm jj tt mm jj period Symbolischer Name einer Periode tt mm jj Datumsangabe f r das Protokoll das gel scht werden soll Wenn auch ein
553. symbolischen Starttermine im Kalender ein und bernimmt auch deren weitere Verwaltung bzgl des Kalen ders Auch Auswahlkriterium zur Bildung von Netzablaufvarianten bei der Planung von Netzen Symdat Kurzname f r Symbolisches Datum oder symbolischer Starttermin SYMDAT NAME Name eines symbolischen Starttermins SYNC INDEX Synchronisationsindex in der Netzbeschreibung tempor re Jobs Jobs mit der Namensstruktur netname jobname in der JMDLIB die einem Netz eindeutig zugeordnet werden k nnen USER Parameter f r ENTER Aufruf des Jobs der S Prozedur oder des AVAS Agen ten AVSSINCM U21462 J Z125 7 537 Fachworter USER PARAM FILE Benutzerdatei mit den aktuellen Werten der Netzablaufparameter mit denen die Jobs eines Netzes bei der Produktion f r den geplanten Ablauf versorgt wer den 538 U21462 J Z125 7 Literatur Die Handb cher sind online unter http manuals fujitsu siemens com zu finden oder in gedruckter Form gegen gesondertes Entgelt unter hrtp FSC manualshop com zu bestellen 1 AVAS V7 0A BS2000 OSD AVAS Anweisungen Benutzerhandbuch Zielgruppe AVAS Benutzer Inhalt Das Handbuch enth lt alle AVAS Anweisungen in alphabetischer Reihenfolge Au erdem sind die Dialogf hrung das Vorbereiten von Jobs f r den Ablauf unter AVAS und die CHECK Funktion beschrieben Bestellnummer U24660 J Z125 5 2 AVAS V7 0A BS2000 OSD AVAS Funktionen Benutzerhandbuch Zielgruppe AVAS B
554. t Die Destination DEST BA40HELIOS muss in der Datei saprfc ini der Benutzer USER AVASS in der Datei sapuser ini gepflegt sein Die LOG Datei wird im Verzeichnis home eich avas avasr3 link LOG Dateien mit dem Namen zztesti log angelegt Beim Start von avasr3 aus der UNIX Shell wird der Inhalt der LOG Datei im aktuellen Fenster ausgegeben Zus tzlich kann man sich noch den Exit Code ausgeben lassen Job zztestl job Start eines R 3 Jobs aus der UNIX Shel l AVASR3PATH home eich avas avasr3_link export AVASR3PATH AVASR3TRACE N export AVASR3TRACE AVASR3LOGFILE AVASR3PATH LOG Dateien zztestl log export AVASR3LOGFILE RFC_INI AVASR3PATH saprfc ini export RFC_INI DEST BAOHELIOS USER AVAS3 JOBNAME ZZTESTI PROGRAMI ZZTESTOO VARIANT1 MAX9999 504 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Steuerung von SAP R 3 Jobs mit AVAS AVASR3 CALL destination DEST user USER job JOBNAME programl PROGRAMI variantl VARIANTI export AVASR3_CALL Start von avasr3 AVASR3PATH avasr3 AVASR3 CALL Auswertung der Ergebnisse case in 0 ERGEBNIS JOB_OK_BEENDET export ERGEBNIS 1 ERGEBNIS RV 0 JOB ABGEBROCHEN export ERGEBNIS 2 ERGEBNIS RV 0 JOB NOCH NICHT GESTARTET export ERGEBNIS 3 ERGEBNIS RV 0 JOB SCHON GESTARTET export ERGEBNIS esac echo ERGEBNIS Die LOG Datei zztest1 10g sieht folgenderma en aus AVASR3 version
555. t U21462 J Z125 7 31 Generierung des AVAS Systems Installation und Generierung Definition der Produktionspl ne Mit der Definition der Produktionspl ne wird einer Produktionsnetzbibliothek NPRmmm eine Produktionsjobbibliothek JMDnnn zugeordnet Die Produktionspl ne m ssen mit dem Schl sselwort PRODTABnnn definiert werden Durch diese Definitionen wird eine Tabelle erstellt in der f r jeden Produktionsplan die zugeh rigen Schl sselw rter eingetra gen werden Jedes der Schl sselw rter NPRnnn und JMDnnn darf systemweit nur einmal in den Produktionspl nen verwendet werden PRODTABOO1 NPRmmm JMDnnn PRODTABOO2 Die Definitionen der Produktionspl ne k nnen im laufenden AVAS Betrieb nicht ge ndert werden Definition der Zuordnung der Netzbibliotheken zu den Produktionspl nen Mit der Definition der Netzproduktionspl ne wird einer Netzbibliothek NETnnn ein Produk tionsplan PRODTABmmm zugeordnet Die Netzproduktionspl ne m ssen mit dem Schl sselwort NET PRO definiert werden NET PRO NET001 PRODTABmmm NET002 PRODTABmmm NETnnn PRODTABmmm Definition der Zuordnung der Maskenbibliotheken zu den Jobbibliotheken Mit dieser Zuordnung werden die Schl sselw rter der Bibliotheken verkn pft die f r die Jobmodifikation durch Benutzermasken ben tigt werden Dazu muss je einer Jobbibliothek JCLnnn je eine Maskenbibliothek MAPmmm zugeordnet werden Die Zuordnung muss mit dem Schl sselwo
556. t p 6 lt STD Dabei ist zu beachten dass es zu einer Verschiebung aller nachfolgenden Parameter kommt wenn einem Namen name ein leerer String zugewiesen wird Somit kommt folgender Job zum Ablauf echo START AVAS Job jobdel echo aus Netz netcheck set filepath C AVAS TEMP Gif STD EQU STD 0060 1 set filepath 26 avas pl echo Jobende U21462 J Z125 7 483 Ablaufsteuerung kontrolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung 11 3 5 6 Starten von Programmen aus Server Jobs auf Windows Systeme Beim Aufruf von Server Jobs k nnen auch andere Programme gestartet werden Hierzu bietet der AVAS Server folgende Schnittstelle an In der ersten Zeile eines Jobs muss folgende Zeile eingef gt werden REM AVAS CALL ext cmd fAVAS DATEINAME param Dabei bedeuten REM Schnittstelle zum AVAS Server kein Kommentar AVAS CALL Aufruf der Schnittstelle Starten Programm ext Endung des zu verwendenden AVAS DATEINAME Beispiel vbs cmd Aufruf des gew nschten Programms Beispiel wscript AVAS DATEINAME F r AVAS DATEINAME wird der Name und Pfad des Jobs auf dem Windows Rechner eingetragen Da dies ein interner Name ist kann der Anwender ihn beim Schreiben ja noch nicht kennen Der Be zeichner muss nicht angegeben werden Die Erweiterung ext wird falls angegeben angeh ngt param Optional k nnen Parameter angegeben werden Nach Auswertung aller Inform
557. t Diese berpr fung wird zyklisch wiederholt anhand der mit dem Operanden SV CONTROL TIME eingestellten Zeitspanne Bei nderungen in der Konfigurationsdatei geschieht Folgendes e Bei neuem Eintrag eines Servers in die Konfigurationsdatei Mit der Operation CONFIG an die Server berwachung kann deren zu berwachende Serverumgebung aktualisiert werden e Bei L schung eines Servers aus der Konfigurationsdatei Mit der Operation CONFIG an die Server berwachung kann deren zu berwachende Serverumgebung aktualisiert werden Damit auch die Ablaufsteuerung die nderung erf hrt muss diese benachrichtigt werden Dies geschieht durch einen Eintrag USERVER in die berwachende Jobvariable U21462 J Z125 7 123 Starten und Beenden der AVAS Prozesse Administration von AVAS Folgende Eintr ge in der SV JV werden von der Ablaufsteuerung ausgewertet U Undefined der Zustand des Servers ist nicht bekannt weil sich z B die AVAS Server berwachung in der Startphase befindet Die Ablaufsteuerung startet Auftr ge f r diesen Rechner R Running der Server ist betriebsbereit und kann Auftr ge entgegennehmen Auftr ge f r diesen Rechner erhalten den Status RUNNING T Terminated Das Programm AVSSINCM konnte keine Verbindung zu dem Server herstellen Der Server ist nicht betriebsbereit oder ber das Netz nicht erreichbar Auf tr ge k nnen nicht entgegengenommen werden Auftr ge f r diesen Rechner erhalt
558. t an ob bei Strukturelementen die Anforderung HOLD gesetzt ist X 00 LOW Der Zustand ist nicht gesetzt X 80 2 7 1 Der Zustand ist gesetzt Beispiel NST1 NST2 NST3 NERR NRST NCWT NHLD X 17 X 00 X 18 X 80 X 00 X 80 X 80 Die Netzverarbeitung wurde ber HOLD NET unterbrochen NST1 HOLD Zum Zeitpunkt der Unterbrechung befand sich das Netz im Ablauf NST3 RUNNING Im Netz befinden sich Strukturelemente bei denen der Status ERROR gesetzt ist Bit 2 7 bei NERR gesetzt Strukturelemente bei denen der Status NO OCCURE gesetzt ist Bit 2 7 bei NCWT gesetzt und Strukturelemente bei denen der Status HOLD gesetzt ist Bit 2 7 bei NHLD gesetzt Wenn der HOLD Zustand aufgehoben wird kommt das Netz in den Status NST3 hier RUNNING Weiterhin ist die Verarbeitung eines Teiles des Netzes zum Stillstand gekommen weil bei der Verarbeitung eines Strukturelements ein Fehler aufgetreten ist Im weiteren Ablauf wird der Status ERROR eintreten wenn vorher kein Restart eingeleitet wird NERR ist gesetzt Weiterhin ist die Verarbeitung eines Teiles des Netzes zum Stillstand gekommen weil eine Bedingung nicht erf llt ist NCWT ist gesetzt Im weiteren Ablauf wird der Status COND WAIT eintreten wenn die Bedingung nicht erf llt werden kann U21462 J Z125 7 392 Programmschnittstelle von AVAS Assembler Schnittstelle AVSASSAN Netzstrukturdaten definieren Makro Parameter AVSASSAN MF C D PREFI
559. t werden VOLUME HAS DIFFERENT DEVICE TYPE F r den angegebenen Datentr ger stimmt der im Archiveintrag hinterlegte Ger tetyp nicht mit dem berein der im DVS Kommando angegeben wurde oder der sich im TSOSCAT Eintrag der Datei befindet VOLUME CONTAINS NO VALID DATA Die angegebene VSN ist laut TSOSCAT Eintrag nicht beschrieben worden und darf daher nicht als Eingabeband verwendet werden VOLUME ONLY USED IN CASE OF RESTART Der Datentr ger wird nur im RESTART Fall ben tigt U21462 J Z125 7 279 Erstellen von Datentr gerlisten 280 U21462 J Z125 7 7 AVAS Reports Analog dem AVAS Dialogsystem kann ein Prozess der REPORT Generator geladen werden Mit dem REPORT Generator k nnen AVAS Reports erstellt und in eine Druck datei die Reportdatei ausgegeben werden Ein AVAS Report ist die Auswertung des AVAS Produktionsplans und der AVAS Journal datei nach vorgegebenen Kriterien Diese Kriterien definiert der Benutzer mit REPORT Anweisungen die der REPORT Generator ber die BS2000 Systemdatei SYSDTA einliest Im PLANNED NET MODIFICATION Report werden Netze ausgewiesen die nach der Pro duktionsplanung ge ndert wurden Im OUT OF PLAN Report werden Netze ausgewiesen die eine definierte Versp tung ber schritten haben und oder die sich in einem ausgew hlten Status befinden Die Menge der zu protokollierenden Netze wird ber den aktuellen Produktionsplan NPRLIB bestimmt Sie kann ber die Vorgabe v
560. tart der Ablaufsteuerung auch ohne Kennwort erfolgen Die Auftrags Jobvariablen die von der Ablaufsteuerung beim Job start angelegt wurden werden mit dem bei MONJV PASSWORD angegebenen Wert als Lesekennwort versorgt Bei SHOW NET STATUS wird der Inhalt der Auftrags Jobvariablen nicht angezeigt Die Auftrags Jobvariablen werden ohne Lesekennwort eingerichtet MONJV RDPASS YES NO Hinweis Die Anweisung wird ignoriert wenn MONJV PASSWORD NONE angegeben wird Die Anmeldung bei der UPAM ZD erfolgt mit dem intern festgeleg ten Kennwort Die Anmeldung bei der UPAM ZD erfolgt mit dem angegebenen Kennwort ZDD PASSWORD STD Wenn ZDD PASSWORD nicht angegeben wird wird STD angenommen Hinweise e Ein Kennwort ist mit der obligatorischen L nge von 4 Byte einzugeben U21462 J Z125 7 114 Administration von AVAS Starten und Beenden der AVAS Prozesse e Die Anmeldung der Ablaufsteuerung an der UPAM ZD ist nur dann erfolgreich wenn das Kennwort mit dem bereinstimmt das beim Start der UPAM ZD mit RCS PASSWORD definiert wurde ZDL PASSWORD STD Die Anmeldung bei der PLAM ZD erfolgt mit dem intern festge legten Kennwort A j Die Anmeldung bei der PLAM ZD erfolgt mit dem angegebenen Kennwort Wenn ZDL PASSWORD nicht angegeben wird wird STD angenommen Hinweise e Ein Kennwort ist mit der obligatorischen L nge von 4 Byte einzugeben e Die Anmeldung der Ablaufsteuerung an der PLAM ZD ist nur dann
561. tei 55 AVAS Dateien 53 Journaldatei 55 FORMAT NAME 530 U21462 J Z125 7 Stichw rter DELETE DOCUMENT BATCH Anweisung 329 DELETE JOB BATCH Anweisung 329 DELETE JOB LOG BATCH Anweisung DELETE JOB LOG Reorganisationsanweisung 171 DELETE NET DESCRIPTION BATCH Anweisung 330 DELETE PERIOD BATCH Anweisung 331 DELETE PLAN NET BATCH Anweisung 332 DELETE PLAN NET Reorganisationsanweisung 171 DELETE PROD JOB BATCH Anweisung 333 330 Diagnoseunterlagen ausgeben 105 Dialog unterbrechen 30 Dialogprozess Startparameter 106 Direktstart von AVAS DOORS 65 DOCLIB 25 54 163 529 DOCSYS 25 54 529 Dokumentationsbibliothek DOCLIB 54 DOCSYS 54 DUE Taste 529 Duplikat Ablaufdatei 26 E EARLIEST START 529 EDT Prozedur f r JOBLOG Protokoll einbinden MARENAV 76 RZ Routinen in AVAS 74 Eingabe in Jobvariablen 127 Eingabedatei weiterverarbeiten 275 einmischen Not Journale 128 einrichten AVAS Dateien 53 Not Journaldatei 26 Einsatzvorbereitung 518 eintragen VSNs bei Ausgabeb ndern 265 VSNs bei Eingabeb ndern 263 VSNs in JCL 263 Elemente aus Systembibliothek anzeigen 8 des Systembenutzerkreises 8 106 550 Stichw rter Identifikation Datenbereich 188 IMON 13 Indexstufe 530 INFORM PROG Kommando 129 Inhalt Jobvariable f r Server Job 469 installieren AVAS DOORS 16 64 AVAS R3JobControl UNIX 445 AVAS R3JobControl Windows 448 AVAS SV 13 AVAS SV BS2000 449 AVAS SV UNIX 445 AVAS SV Windows
562. tei Se tup avs gespeichert sie k nnen dort auch nachtr glich ge ndert werden Die g ltigen Installations Parameter werden in einer bersicht am Bildschirm angezeigt sie m ssen vom Anwender best tigt werden Erst danach werden die Produktdateien in das entsprechende Installationsverzeichnis kopiert Die Installation von AVAS R3JobControl erfolgt analog zu der des AVAS Servers Mit q uit kann der Dialog verlassen werden Das Produkt wird in diesem Fall nicht installiert Installation von AVAS SV auf IBM AIX HP UX UnixWare Tru64 UNIX und LINUX Die Installation von AVAS SV auf diesen Plattformen ist durch Sonderfreigaben geregelt ebenso die Zusatzfunktionalit t aus AVAS R3JobControl Die Installation erfolgt mit install avs Auch auf diesen Systemen muss die CD ROM gemountet werden damit auf ihre Daten zugegriffen werden kann e IBMAIX Mounten Sie die CD mit dem Kommando mount v cdrfs o ro device lt mountpoint gt f r device z B dev cd0 f r lt mountpoint gt z B cdrom e HP UX V10 V11 Mounten Sie die CD mit dem Kommando mount o cdcase device lt mountpoint gt f r device z B dev dsk c0t4d0 f r lt mountpoint gt z B cdrom UnixWare Mounten Sie die CD mit dem Kommando mount F cdfs r lt device gt lt mountpoint gt f r device z B dev cdrom c1b0t510 f r lt mountpoint gt z B CR ROM_1 e Tru64 UNIX Mounten Sie die CD mit dem Kommando mount r lt device gt lt mou
563. teiversion ist nicht durch das Zeichen von der Zeichenfolge VOL getrennt Die Produktionsfreigabe wird abgebrochen U21462 J Z125 7 277 Erstellen von Datentr gerlisten NO USERID SPECIFIED Weder beim Dateinamen noch im BS2000 Kommando SET LOGON PARAMETERS wurde eine Kennung angegeben Auch AVAS hat keine am SUBMIT Exit bergeben Die Produktionsfreigabe wird abgebrochen DEVICE TYPE MISSING OR INVALID Die Produktionsfreigabe wird aus einem der folgenden Gr nde abgebrochen 1 Ein Platzhalter wurde in Verbindung mit einem Ger tetyp ungleich Band oder Kassette verwendet 2 Bei der Anforderung von SCRATCH bzw PRIVATE B ndern wurde ein ung ltiger Ger tetyp angegeben FILENAME VERSION NOT FOUND IN MAREN CATALOG Bei Angabe von VOL wurde der Dateiname nicht gefunden oder bei VOL nnn wurde die angegebene Dateiversion nicht gefunden oder die DEVICE Angabe ist unterschiedlich Die Produktionsfreigabe wird abgebrochen DIFFERENT USERIDS useridl userid2 IN MAREN CATALOG Bei Angabe von VOL und UID SAME wurden zum aktuellen Dateinamen B nder mit unterschiedlichen Benutzerkennungen im MAREN Katalog gefunden Die Produktionsfreigabe wird abgebrochen VOLUMES OF MULTI VOLUME SET ARE MISSING Bei Angabe von VOL wurde festgestellt dass f r den aktuellen Dateinamen nicht alle Archivnummern des Multivolume Sets im MAREN Katalog eingetragen sind Die Produktionsfreigabe wird abgebrochen VOLUMES
564. ten berschriften Satzschl ssel Benutzerkreis Netzname Plan Start Datum Plan Start Zeit Symbolischer Starttermin Index Jobname Funktion Typ letzte Startzeit letzte Laufzeit letzte Endezeit Anzahl Abl ufe mittlere Laufzeit Job maximale Laufzeit Job minimale Laufzeit Job Range Standardabweichung mittlere Wartezeit ERROR maximale Wartezeit ERROR mittlere Anzahl ERROR Anzahl Zeiten Plan Start Datum Zeit Laufzeit Jobs 1 Wartezeit ERROR 1 Anzahl ERROR 1 Plan Start Datum Zeit Laufzeit Jobs 64 Wartezeit ERROR 64 Anzahl ERROR 64 Aufbau der History Datei Lange 20 30 54 54 Lange 20 3 30 Fortsetzung e 219 Inhalt KEY 03 bk netname YYYYMMTT hhmmss SYMDATNAME FU N TYPE NET tt mm yyyy hh mm ss hhh mm ss tt mm yyyy hh mm ss hhh mm ss hhh mm ss hhh mm ss 01 99 filename filename Inhalt KEY 04 bk netname YYYYMMTT hhmmss SYMDAT NAME IND bk jobname Sicherung und Reorganisation KEY 03 Ablauf Netz Spalten berschriften Satzschl ssel Benutzerkreis Netzname Plan Start Datum Plan Start Zeit Symbolischer Starttermin Index Jobname Funktion Typ Startzeit Laufzeit Endezeit Laufzeit Jobs Wartezeit Conditions Wartezeit ERROR Anzahl ERROR JRNDAT SAVE FILE JOBLOG SAVE FILE KEY 04 Ablauf Job Spalt
565. ter sind Felder der Maske AVSO11 siehe Handbuch AVAS Anweisungen 1 Protokoll der Verarbeitung F r jedes kopierte Element wird AVS8521 COPY ELEMENT elementname RESULT ergebnis ausgegeben oder eine Fehlermeldung U21462 J Z125 7 319 CREATE PERIOD BATCH Anweisungen CREATE PERIOD Erstellen einer Periode Die BATCH Anweisung CREATE PERIOD erzeugt einen Eintrag in der Periodendatei mit dem angegebenen PERIOD NAME und den vorgegebenen Zeitgrenzen der Periode ber diese BATCH Anweisung k nnen Perioden mit variablem Start und End Datum defi niert werden Standard Perioden Bei der Definition von Perioden sind Ersatzzeichen zum Erstellen variabler Perioden zuge lassen Die Werte der Ersatzzeichen werden ber das aktuelle Tagesdatum ermittelt Ersatzzeichen sind nur im Datum zugelassen Es wird immer das laufende Jahr angenom men Die Uhrzeit kann auch bei Perioden wie HEUTE vorgegeben werden Variable Perioden mit Ersatzzeichen k nnen nur ber die BATCH Anweisung CREATE PERIOD eingelesen und ber die BATCH Anweisung DELETE PERIOD gel scht werden Variable Perioden sind in der Anzeige mit TYPE VAR gekennzeichnet Sie k nnen mit der Dialog Funktion MODIFY PERIOD nicht geandert werden Zugelassene Ersatzzeichen Tag tt realer Tag Wird der Monat relativ angegeben ist der gr te zul ssige Wert 28 0 aktueller Wert aus dem Tagesdatum t aktueller Tag t Tage t aktueller Tag t Tage
566. tet dann im QUERY Modus AVSSINCM baut eine Verbindung mit dem AVAS Server auf der in den Konfigurationsda ten ber hostname und lt portnr gt adressiert ist Der Server Job wird falls er in AVAS ge speichert ist bertragen Anschlie end wird der Auftrag gesendet den Job zu starten Die Angabe server name erfolgt e in der Netzbeschreibung Maske AVNOOO9 bei UNIX und Windows Jobs bzw Masken AVNO01 AVNOO2 bei BS2000 Jobs siehe Handbuch AVAS Anweisungen 1 oder wenn dort STD eingetragen ist e beider Definition der Benutzerkreise BK in der Generierungsdatei AVAS USER GENPAR oder wenn dort STD eingetragen ist e in der Startprozedur AVS SINCM des AVSSINCM 456 U21462 J Z125 7 AVAS SV Plattform bergreifende Jobsteuerung Ablaufsteuerung kontrolle von Server Jobs Hinweis e Welche Schnittstelle AVSSINCM zum AVAS Server benutzt ist abh ngig von dessen Version Ab V7 0 wird eine XML Schnittstelle verwendet bei AVAS Servern mit einer Version kleiner als V7 0 ist es weiterhin die alte Schnittstelle e Hierzu muss die Version des AVAS Servers in der jeweiligen Server Jobvariablen ein getragen sein Das Eintragen erfolgt ber den AVAS Prozess Server berwachung Wenn ohne Server berwachung gearbeitet wird muss der Benutzer die Version in die Server Jobvariable eintragen e Wenn AVSINCM den AVAS Server nicht ber die richtige Schnittstelle anspricht erhal ten die Serverjobs den Status
567. tfernt Der Zugriffspfad wird ber den mit AVAS USER ID angegebenen Benutzer und die Eintra gungen in den System Parametern bestimmt F r den angegebenen Benutzer muss die Berechtigung f r die Anweisung SHOW SYSTEM PARAMS vorliegen Wenn die Berechti gung nicht vorliegt wird die Reorganisation mit Fehlermeldung abgebrochen Wenn kein Zugriffspfad ermittelt werden kann bleiben die Netze im Produktionsplan stehen Es wird dazu keine Meldung ausgegeben END Mit der Reorganisationsanweisung wird die Anweisungseingabe beendet Die Angabe ist wahlfrei Wenn die Anweisung nicht gegeben wird stellt die Reorganisation das Ende der Eingabe durch End of File bei SYSDTA fest U21462 J Z125 7 171 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation FUNKTION Durch diese Reorganisationsanweisung wird dem Reorganisationsprogramm mitgeteilt welche Dateien im AVAS System reorganisiert werden sollen Diese Anweisung muss angegeben werden Die Anweisung hat zwei Formate FUNKTION funktionT oder FUNKTION funktion 1 funktion2 funktionS funktion4 funktion5 funktion1 funktion5 Eine der Funktionen JRNDAT SJOUR ABLDAT JOBLOG oder HISTORY Die Angabe der Funktionen JOBLOG und HISTORY ist wahlfrei Die Funk tionen m ssen in Klammern angegeben werden Dabei m ssen wenigs tens die drei Funktionen JRNDAT SJOUR und ABLDAT in beliebiger Rei henfolge angef hrt sein Die Reihenfolge hat Einfluss auf die Lebensdauer
568. theken SYSLNK AVAS 070 und SYSPRG AVAS 070 SYSTEM ben tigt Beispiel BEGIN PROC LOGG NO PAR YESCPROC PAR amp AUSERID amp REPORT amp DELETE amp AVSYID amp AVSYPW STD amp AVUSID amp AVUSPW ESC CHAR C amp RE AR desk ese Ke he ee dee de eee eoe e ehe dede eK ede eee ee eee e ee eee ee ee dede e Se ee de dee decks REMARK amp USERID BENUTZERKENNUNG DER AVAS INSTALLATION REMARK amp REPORT OOP PNM OUT OF PLAN PLAN NET MODI REMARK amp DELETE YES NO VORHANDENE DATEIEN LOESCHEN REMARK REMARK amp AVSYID AVAS SYSTEM ID REMARK amp AVSYP AVAS SYSTEM KENNWORT REMARK amp AVUSID AVAS USER ID REMARK amp AVUSPW AVAS USER KENNWORT SYNTAX C D RE AR SKIP CO DELZ amp DELETE DELZYES REMAR gt DATEIEN LOESCHEN CREATE FILE FILE NAME AVAS WORK REPORT amp REPORT DELETE FILE FILE NAME AVAS WORK REPORT amp REPORT CREATE FILE FILE NAME AVAS FILE REPORT amp REPORT DELETE FILE FILE NAME AVAS FILE REPORT amp REPORT DEL NO EMAR gt DATEIEN NICHT LOESCHEN SKIP CO REP amp REPORT REP 00P REMAR gt 00P REPORT SET FILE LI LINK NAME SYSLN
569. tion der aktuelle Zustand des Server Jobs ermittelt e GServer Jobs die bei Ausfall der Kommunikation im Status RUNNING waren und in der Zwischenzeit beendet sind erhalten den Status ENDED oder ERROR Server Jobs die noch nicht beendet sind bleiben weiter im Status RUNNING F r in der Zwischenzeit beendete Server Jobs werden die LOG Dateien erfa t e Server Jobs die wegen Problemen mit der Kommunikation zum Server nicht dort hin bertragen werden k nnen erhalten den Status ERROR Bei einem RESTART erkennt AVAS dass der Job noch nicht zum Ablauf gekommen ist und versucht ihn erneut zu starten Die obigen Betrachtungen gelten auch f r den Fall dass der AVAS Agent AVSSINCM ausf llt U21462 J Z125 7 515 AVAS SV Plattform bergreifende Jobsteuerung 4 Ausfall des mySAP com Systems Das mySAP com System muss neu gestartet werden Der AVAS Server bleibt geladen R3 Jobs erhalten den Status ERROR In der Netzbeschreibung kann eingestellt werden wie die AVAS Ablaufsteuerung auf den ERROR reagieren soll Bei RESTART ermittelt das Programm avasr3 den aktuellen Jobstatus ENDED ERROR des mySAP com Systems mySAP com Jobs die noch nicht be endet sind bleiben weiter im Status RUNNING Die Informationen ber gestartete mySAP com Jobs sind am AVAS Server gespeichert Ausfall der Kommunikation zwischen dem Programm avasr3 und dem mySAP com System F r einen fehlerfreien Produktionsablauf ben tigt AVAS die Kommunika
570. tion zum mySAP com System Gestartete mySAP com Jobs oder solche die w hrend des Ausfalls der Kommuni kation gestartet werden sollten erhalten den Status ERROR Der Status ERROR wird gesetzt wenn es nach wiederholten Versuchen nicht gelungen ist die Verbin dung wiederherzustellen Wenn die Kommunikation wieder verf gbar ist wird bei RESTART f r bereits gestartete mySAP com Jobs das Ergebnis ermittelt QUERY Modus noch nicht gestartete Jobs werden gestartet Ausfall des AVAS Servers Unabh ngig vom Betriebssystem UNIX oder Windows System BS2000 OSD muss der AVAS Server neu gestartet werden Server Jobs die zum Ausfallzeitpunkt im Status RUNNING waren laufen bis zum Jobende weiter Da der AVAS Agent AVSSINCM die Verbindung zum Server verlo ren hat erhalten diese Server Jobs in der Ablaufdatei den Status ERROR COM Mit Restart auf diese ERROR COM Jobs wird das Ergebnis des Server Jobs ermit telt QUERY Modus wenn der Server wieder zur Verf gung steht Neue Server Jobs k nnen bis zum Neustart des AVAS Servers nicht gestartet wer den und erhalten den Status ERROR COM Mit RESTART auf diese ERROR COM Jobs kann das Starten des Server Jobs erneut angesto en werden START Modus wenn der AVAS Server wieder verf g bar ist U21462 J Z125 7 6 Verhalten im Fehlerfall 516 AVAS SV Plattform bergreifende Jobsteuerung Verhalten im Fehlerfall Hinweise CANCEL auf AVSSTRT AVSSINCM kann nicht unterscheid
571. tionsschritte kann bestimmt werden wenn die Funktionen in der Form FUNKTION funktion 1 funktion2 funktion3 vorgegeben werden Bei dieser Form des Reorganisationsablaufs werden alle drei Schritte durchgef hrt Es sind daher die drei Funktionen in der gew nschten Reihenfolge anzugeben Hinweis Durch die Reorganisation wird die Datei nicht kleiner als zuvor da nur der Inhalt der Datei reorganisiert wird 4 1 2 Reorganisation der Protokolldatei Die Reorganisation kann im laufenden Betrieb erfolgen Wenn das Reorganisationsprogramm direkt auf die AVAS LOGSYS Bibliothek zugreifen kann kopiert es selbst die Protokolle in die angegebene Datei oder Bibliothek Kann es das nicht werden die Protokolle ber den PLAM Zugriffsprozess gelesen und in die Siche rungsdatei bzw Bibliothek geschrieben Direkt zugreifen kann das Reorganisationsprogramm dann wenn e es unter der gleichen Benutzerkennung l uft wie die PLAM ZD und e die AVAS LOGSYS Bibliothek nicht kennwortgesch tzt ist oder das Kennwort vor dem Programmstart im Reorganisationsjob mit dem BS2000 Kommando ADD PASSWORD zugewiesen wurde 166 U21462 J Z125 7 Sicherung und Reorganisation Reorganisation der AVAS Benutzerdateien Die Reorganisation wird durch die Prozedur AVS REORG Element der Bibliothek SYSPRC AVAS 070 gestartet und erh lt ber Parameter Steuerungsinformationen Danach k nnen das Sichern und L schen der Protokolldaten in einem Lauf oder in getrenn ten L
572. trolle von Server Jobs AVAS SV Plattform bergreifende Jobsteuerung Den Status eines Server Jobs beim Beenden von AVSSINOM setzt die Ablaufsteuerung nach der Auswertung des SV Status folgenderma en RUNNING Job AVSSINCM ist noch nicht beendet ENDED SV Status steht auf T und die Monitor Jobvariable enth lt T f r den Job AVSSINCM ERROR Bei allen anderen Einstellungen siehe AVSSINCM Der SV Status kann ausgegeben werden ber die Anweisung SHOW NET STATUS ge nauere Parameter Beschreibung siehe Handbuch AVAS Anweisungen 1 AVSSINCM Nach dem Lesen der Eingabe Parameter pr ft AVSSINCM den Inhalt von SV Status in sei ner ablauf berwachenden Auftrags Jobvariablen Anhand der Einstellungen erkennt AVSSINCM ob der Server Job e erstmalig gestartet werden soll SV Status leer Der Job wird zum Server bertragen AVSSINCM arbeitet im START Modus e bereits gelaufen ist jedoch ber den Wert RVzn in der Monitor Jobvariable ein Jobfeh ler gemeldet und ein Restart gefordert wurde Der Job wird zum Server bertragen AVSSINCM arbeitet im START Modus e bereits gestartet war das Ergebnis aber noch nicht an die Ablaufsteuerung gemeldet wurde Dies ist z B der Fall wenn die Verbindung zum Server w hrend des Joblaufs unterbrochen und der SV Status auf E gesetzt wird Byte 184 in der MONJV des Jobs AVSSINCM Der Job erh lt den Status ERROR Mit RESTART NET kann dann vom Server das Ergebnis ermittelt werden AVSSINCM arbei
573. tstart char 7 symbolischer Name der sp testen Startzeit nettexttab Die Tabelle nettexttab enth lt die Zuordnung von Texten der Netzbeschreibung zu Netzen bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname nettext char 120 Text der Netzbeschreibung ordertab Die Tabelle ordertab enth lt die Zuordnung von Pubsets zu Jobs und die Zuordnung von Jobs zu Netzen sowie die Abh ngigkeiten von einem Netz Job Bedingungswert Betriebs mittel oder einer Jobvariablen bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname indexnr char 3 Indexstufe bkorder char 4 Benutzerkreis des Strukturelements ist f r die Bedin gung JOB oder NET kein Benutzerkreis angegeben wird der Benutzerkreis des Netzes eingetragen ordername char 24 Name des Strukturelements function char 1 Funktion FU des Strukturelements J Job P S Prozedur X Server Job S Start C Compare W Wait M Modify D Delete A Add typ char 3 Typ des Strukturelements Jobauftrag MOD STD EXT EXX Bedingung NET JOB VAL RES JVA WAIT TIM Startauftrag NET U21462 J Z125 7 249 Dienstprogramm AVAS QUER dem Job zugeordnetes Pubset oder Jobvariable die das Pubset enth lt zur Unterscheidung von Pubset und JV steht Pubset in Hochkommata f r functionzJ P X Name der Jobvariable f r typ JVA Name der Enterdatei f r typ EXT Indexstufe des Jobs zu dem die Abh ngigkeit besteht f r typ JOB Benutzerkr
574. tuelle Dialogschritt abgeschlossen ist Die ZD wird f r Neuanmeldungen gesperrt HOLD Mit der Eingabe von HOLD wird die betreffende ZD f r Neuanmel dungen gesperrt RESUME Mit der Eingabe von RESUME wird eine Anmeldesperre aufgeho ben Hinweise e Die Anmeldesperre der JV Operation gilt l ngstens bis zum Ende der AVAS Sitzung wenn sie nicht durch den JV Eintrag RESUME vorher aufgehoben wird Nach erneutem Hochfahren von AVAS sind alle Sperren aufgehoben e Es gibt keine JV Operation um nur bestimmte Benutzer von der Anmeldung auszu schlieBen U21462 J Z125 7 127 Bedienen und berwachen der AVAS Prozesse Administration von AVAS e Beiden Operationen CANCEL und HOLD wird keine Anmeldesperre in den System Parametern f r die betroffenen Benutzer gesetzt e Die Operation RESUME muss an die gleiche ZD gegeben werden die zuvor das Kom mando HOLD erhalten hat da sie sonst wirkungslos bleibt Operationen zum Beenden der Zugriffsprozesse SHUTDOWN Die ZD Prozesse k nnen nur ber das BS2000 Kommando MODIFY JV f r die den Prozess berwachende Jobvariable been det werden MODIFY JV JV IDENTIFICATION JV NAME jvname VALUE C SHUTDOWN Die Prozesse werden beendet sobald kein Benutzer mehr aktiv ist ZDPLAM Sich kein Netz mehr im Ablauf befindet UPAM ZD und keine Ablaufsteuerung mehr aktiv ist UPAM ZD Neue Benutzer k nnen sich nicht mehr anmelden bzw neue Netze werden nicht m
575. tung bergeben Das normale oder abnormale Auftragsende kann kontrolliert und protokolliert werden Die Information Jobbeendigung kann an andere Programmsysteme oder Arbeitsgebiete wei tergegeben werden U21462 J Z125 7 70 Installation und Generierung RZ Exits im AVAS System Der Ausgang AVEX0403 wird aktiviert wenn ein BS2000 Job eine S Prozedur oder ein Server Job von der Ablaufsteuerung den Status ENDED ABENDED oder ERROR in der Ablaufdatei erhalten hat RZ Exit AVEX2001 Aktivieren einer RZ Routine durch den Benutzer ber START EXIT Der Benutzer kann hier seine eigene Benutzer Routine in die Verarbeitung des AVAS Systems einbringen Der Ausgang AVEX2001 wird aktiviert wenn der Benutzer die Anweisung START EXIT ein gibt Der RZ Routine werden im Kommunikationsbereich keine Daten bergeben Die RZ Routine kann eine Meldung zur ckgeben die im Feld MSG der Maske 481 5030 ausge geben wird R ckgaben im Feld RETURNCODE wertet AVAS nicht aus RZ Exit AVEX6601 Eingaben f r Netzmasken Wenn JCL Anweisungen eines Jobs mit Hilfe einer im Netz vorgegebenen Benutzermaske Parameter OBJECT MAP der Anweisung CREATE NET DESC modifiziert werden sol len muss die Anweisung COLLECT NET PARAMS zum Erfassen der Eingaben f r die Be nutzermaske verwendet werden Nach Aufruf der Anweisung k nnen den AVAS Variablen N nnn durch eine RZ Routine die aktuellen Werte der Ablauf Parameter zugeordnet wer den Die bergebenen We
576. tung f r AVAS QUER Dienstprogramm AVAS QUER ordersturntab Die Tabelle ordersturntab enth lt die Zuordnung von SELECT TURNUS zu Strukturelemen ten bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname indexnr char 3 Indexstufe bkorder char 4 Benutzerkreis des Strukturelements ordername char 24 Name des Strukturelements selectturnus char 1 SELECT TURNUS ordertexttab Die Tabelle ordertexttab enth lt die Zuordnung von Texten der Netzbeschreibung zu den Strukturelementen der Netze bknet char 4 Benutzerkreis des Netzes netname char 12 Netzname indexnr char 3 Indexstufe bkorder char 4 Benutzerkreis des Strukturelements ordername char 24 Name des Strukturelements ordertext char 120 Text der Auftragsbeschreibung function char 1 Funktion FU des Strukturelementes typ char 3 Typ des Strukturelementes 252 U21462 J Z125 7 Dienstprogramm AVAS QUER Datenhaltung f r AVAS QUER 5 3 5 Beispiele f r Datenbankabfragen Die nachfolgenden Beispiele zeigen welche SQL Anweisungen der Benutzer im Ziel System absetzen muss um die auf Seite 231 aufgef hrten gew nschten Informationen zu erhalten 1 In welchen Netzen wird ein bestimmter Job verwendet Beispiele In welchen Netzen wird der Job SQUER JOB1 verwendet SELECT bknet netname FROM ordertab WHERE Cordername JOB1 AND bkorder QUER AND function J n welchen Netzbeschreibungen wird das symbolische Datum SYMDATE 10 verwendet
577. tung zur ckmelden pfixOK EQU X 00 Die Felddaten werden f r die Modifikation des Jobs ber nommen Die Modifikation wird ausgef hrt pfixNO EQU X 04 Die Felddaten werden wegen eines Eingabefehlers nicht ber nommen Die Netzmaske wird mit bergebener Meldung erneut ausgegeben CMD CONTINUE wird gel scht pfixiGN EQUX 06 Abbruch der Modifikation f r diese Netzmaske Verhalten wie bei CMD IGNORE im Dialog pfixABE EQUX 08 Abbruch der Modifikation Verhalten wie bei CMD RETURN im Dialog U21462 J Z125 7 93 Installation und Generierung RZ Exits im AVAS System Hinweise e Die RZ Routine bergibt alle AVAS Variablen mit ihren Wertzuweisungen au er S nnn e Bei pfixRSC X 04 sollte eine Meldung in Feld pfix FMSG bergeben werden e Wenn die RZ Routine andere Returncodes zur ckmeldet setzt AVAS im Feld MSG eine Meldung ab die Modifikation wird nicht durchgef hrt e Modifikationen durch die RZ Routine an den bergebenen Daten bernimmt AVAS 2 4 14 RZ Exit AVEX6801 nicht Bevor eine zugeordnete Benutzermaske ausgegeben wird ruft AVAS die RZ Routine auf Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine wie Ausgabe Parameter Netzname Ausgabe Parameter Job Index Ausgabe Parameter Jobname Ausgabe Parameter Name der Jobmaske wird nicht verwendet Ausgabe Parameter EQUATE f r L nge des Basisdatenteils folgt pfixNNAM pfixJIND
578. tungsname 295 PERIOD NAME Ausw hlen Netze ber das Startdatum PLAN START 296 REPORT NAME Ausw hlen von Reports 296 SELECT STATUS Ausw hlen Netze gemap ih er 297 SORT FIELDS ORDER Festlegen der Fisihenicke d det rbortienielder 298 SORT STATE ORDER Festlegen der Reihenfolge der Netze f r die Reportdatei 9 SYSTEM PASSWORD Anmelden beim zentralen Zugriffsprozess 300 THRESHOLD Ausw hlen Netze gem f ihrer Versp tung m 301 USER PASSWORD Angeben des Benutzerkennworts 301 U21462 J Z125 7 Inhalt PLANNED NET MODIFICATION Report i OUT OF PLAN PFISDOIT ak RR Prozeduren und Bibliotheken f r die AVAS Reports BATCH Funktionen BATCH Anweisungen ADD JOB LOG Hinzuf gen von Protokolldaten CANCEL NET Unterbrechen oder Abbrechen Netz wegen Fehlers CHANGE NET DESCRIPTION Massen nderung von Netzen COPY ELEMENT Kopieren der Bibliothekselemente CREATE PERIOD Erstellen einer Periode CREATE PLAN NET Planung der Netzverarbeitung CREATE PROD JOB Erstellen statischer BS2000 Jobs S Prozeduren und Server Jobs CREATE PROD NET Erstellen tempor rer BS2000 Jobs S Prozeduren und Server Jobs eines Netzes DELETE DOCUMENT L
579. tus ERROR muss eindeutig zu identifizieren sein da sonst der Restart zur ckgewiesen wird ERROR INDEX ist der Index des Strukturelements im POINT OF ERROR ERROR NAME ist der Name des Strukturelements im POINT OF ERROR Die beiden Parameter m ssen sich auf ein Strukturelement mit Status ERROR beziehen Wenn sich ein Strukturelement im Bereich der Restart Indexstufen Index 900 999 im Status ERROR befindet muss dieses vorrangig vor allen anderen Elementen mit Status ERROR bearbeitet werden Wenn der Parameter RUN CONTROL SYSTEM nicht angegeben wird wird der Name der Ablaufsteuerung ber die Anmeldedaten ermittelt Wenn der Parameter RESTART VARIANT nicht angegeben wird wird der Restart mit der ber die Auftrags Jobvariable gesetzten Restart Variante eingeleitet Wenn ber die Auf trags Jobvariable keine Restart Variante gesetzt ist wird der Restart mit einer Fehlermel dung zur ckgewiesen Wenn der Parameter RESTART VARIANT angegeben wird wird der Restart ber die vor gegebene Variante eingeleitet Es wird nicht gepr ft ob ber die Auftrags Jobvariable eine Restart Variante gesetzt ist U21462 J Z125 7 339 RESTART NET BATCH Anweisungen Protokoll der Verarbeitung F r das gestartete Netz wird AVS8521 RESTART NET netname RESULT ergebnis ausgegeben oder eine Fehlermeldung 340 U21462 J Z125 7 BATCH Anweisungen RESUME NET RESUME NET Aufl sen des HOLD Zustandes Mit RESUME NET kann die Ve
580. u L schen Strukturelement Parameter FU J P X alt Parameter FU J P X neu Parameter FU C TYPE JVA alt Parameter FU C TYPE JVA neu Parameter FU C A M D W alt Parameter FU C A M D W neu Ende der Funktion Abbruch der Funktion Fehlermeldung MODIFY SUBMIT JOB Start nderung BS2000 Job S Prozedur Server Job JCL Anweisung alt JCL Anweisung neu JCL Anweisung l schen Ende der Funktion Abbruch der Funktion Fehlermeldung AVAK Ablaufsteuerung Start eines Netzes Ende eines Netzes w hrend die Ablaufsteuerung nicht aktiv war HOLD CONDWAIT IT es Netzes U J P X Start nach oder HOSTWA Restart ein Start von F normales Ende von FU J P X Ende von FU J P X abnormales Anweisung ABLDAT x Anweisung ABLDAT x S52 AVASJRN 552 AVASJRN MSG7 Text 5 AVASJR S51 AQVASJRN 5 AVASJR 5 AVASJR S52 AVASJR S52 AVASJR S52 AVASJR S59 AVASJR S59 AVASJR S59 AVASJR 57 AVASJR 57 AVASJR 57 AVASJR 57 AVASJR 57 AVASJR 53 AVASJR U21462 J Z125 7 FU S on FU S C W J P X C W A D M D M W C TYPE JVA Start von FU S normales Ende von abnormales Ende v CONDWAIT wegen FU HOSTWAIT wegen FU Erf llung von FU Ausf hrung von FU Fehler bei FU C A CONDWAIT wegen FU SSL FNR 52 00 65 01 65 02 65 04 52 07 52 08 09 00 51 00 51 02 51 03 51 03 52 00 52 07 52 08 59 00 59 07 59 08 57 03 57 03 57 07 57 07 57 08 53 03 196 Sicherung und Reorganis
581. uch AVAS Funktio nen 2 und durch die Ablaufsteuerung werden Journals tze in die Journaldatei ausgege ben Bevor AVAS die S tze ausgibt werden sie ber die RZ Exits AVEX0001 und AVEX0002 an eine RZ Routine bergeben Im RZ Exit AVEX0001 werden die Journals tze weiterhin im Format von AVAS V3 0A Ausgabedatum ohne Jahrhundert bergeben Im RZ Exit AVEX0002 werden die Journals tze im Format Ausgabedatum mit Jahrhun dert bergeben Mit der RZ Routine kann die Ausgabe folgender Journals tze unterdr ckt werden Anweisung SSL Funktion CREATE PLAN NET 12 Ausgabe Strukturelement 12 L schen Strukturelement CREATE PROD NET 21 Parameter USER PAR FILE 22 Zuordnen Maske 23 Aufruf Baustein 25 Parameterersetzung EDIT PROD JOB 65 JCL nderung SUBMIT NET 25 JCL Anweisung EX7102 32 Ausgabe BS2000 Job S Prozedur Server Job 54 Ausgabe Strukturelement nicht BS2000 Job S Prozedur Server Job REPEAT NET 25 JCL Anweisung EX7102 32 Ausgabe BS2000 Job S Prozedur Server Job 54 Ausgabe Strukturelement nicht BS2000 Job S Prozedur Server Job MODIFY SUBMIT JOB 65 JCL nderung 68 U21462 J Z125 7 Installation und Generierung RZ Exits im AVAS System Hinweise e Der Ablauf der AVAS Funktion kann durch den RZ Exit nicht beeinflusst werden e Der Inhalt der Journals tze wird zur Verf gung gestellt e Die Start Ende und Abbruchmeldungen d
582. uerungen Die Parameter der Ablaufsteuerungen k nnen ohne Einschr nkungen ge ndert werden Wenn allerdings der Name einer Ablaufsteuerung ge ndert wird ist dies gleichbedeutend mit dem L schen eines RUN CONTROL SYSTEM und der Definition eines neuen Zu beachten ist dass die Netze unterhalb eines gel schten RUN CONTROL SYSTEM nicht mehr verarbeitet werden k nnen In der Ablaufdatei und der Journaldatei wird das RUN CONTROL SYSTEM aber nicht gel scht damit ber die Dialogfunktionen auf die unterhalb des RUN CONTROL SYSTEM gespeicherten Netze noch zugegriffen werden kann z B ber MODIFY SUBMIT NET um Netze auf ein anderes RUN CONTROL SYSTEM verlagern zu k nnen Neu definierte RUN CONTROL SYSTEM werden beim Start des Zugriffsprozesses f r die Ablaufdatei und die Journaldatei in die Inhaltsverzeichnisse der Dateien eingetragen Sie k nnen uneingeschr nkt genutzt werden Andern der symbolischen Namen der AVAS Anweisungen und Variablen Wenn die symbolischen Namen der AVAS Anweisungen und oder der AVAS Variablen ge ndert werden m ssen alle Jobs in denen diese verwendet werden angepasst werden U21462 J Z125 7 47 Generierung des AVAS Systems Installation und Generierung 2 2 4 Erstellen der Generierungs Parameter aus den System Parametern In einem aktiven AVAS System k nnen die einmal generierten System Parameter interak tiv ge ndert werden Dadurch ndern sich im laufenden Betrieb die Informationen der Sys te
583. uf formale Richtigkeit gepr ft werden Insbesondere muss bei S Prozeduren und Server Jobs der Trenn String zur Trennung von Anweisungen und Parametern generiert werden gem der Festlegung ber die System Parameter siehe DEFAULT PROPCAR STRING auf Seite 40 Bei der Generierung von BS2000 Jobs S Prozeduren und Server Jobs kann auf Kommen tare weitgehend verzichtet werden um die Systemdateien zu entlasten Die Dokumentation der BS2000 Jobs S Prozeduren und Server Jobs kann innerhalb von AVAS in der DOCLIB abgelegt werden 9 3 Externe Erstellung von Dokumenten Innerhalb von AVAS k nnen den Netzen und den Strukturelementen der Netze Dokumen tationselemente zugeordnet werden Diese Dokumentationselemente k nnen auch extern au erhalb des AVAS Systems ber geeignete Editoren erstellt und ber COPY ELEMENT in die AVAS Bibliothek DOCLIB ein gelesen werden Zu beachten ist dass die Dokumentationselemente nach der Operation DOCUMENT ber EDT angezeigt werden Die Satzl ngenbeschr nkungen des EDT sind deshalb zu ber ck sichtigen F r die Zuordnung der Dokumente zu den Netzen und den Strukturelementen der Netze sind die Namenskonventionen zu beachten siehe auch die Operation DOCUMENT und die Anweisung CREATE NET DESCRIPTION im Handbuch AVAS Anweisungen 1 372 U21462 J Z125 7 10 Programmschnittstelle von AVAS Die Programmschnittstelle von AVAS erm glicht es ausgew hlte AVAS Funktionen aus einem Benutzerpr
584. ufen durchgef hrt werden Grunds tzlich gilt Folgendes e Gesichert werden alle Protokolleintr ge die den Status TRANSFERRED ADDED oder IGNORE haben e Geloscht werden alle Protokolleintr ge die den Status SAVED haben oder die laut Angabe des Steuerungs Parameters gel scht werden sollen e Der Parameter DELETE JOB LOG muss mit YES angegeben sein Hinweis Durch die Reorganisation wird die Bibliothek der Protokolle nicht kleiner als zuvor da nur der Inhalt der Datei reorganisiert wird 4 1 3 Ablauf des Reorganisationsprogramms Das folgende Bild zeigt den Ablauf der Reorganisation Standardreihenfolge und die an den einzelnen Schritten beteiligten Dateien U21462 J Z125 7 167 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation FUNKTION SYSDTA Anweisungen Dateien Verzeichnis gesicherter Journale SAVED JRNDAT Netze DELETED SJOUR Status SAVE Sichern Journalsicherung Netze DELETED JRNDAT HSTSYS Erfassen HISTORY Daten ABLDAT Netze ENDED ABENDED ABLDAT L schen Status DELETED JRNDAT gt NPRLIB L schen Netze wenn DELETE PLAN NET YES wenn JOBLOG SAVE OPTION STD LOGSYS Status SAVED JOBLOG SAVE OPTION YES JOBLOG L schen ENG LOGSAVE HISTORY HISTORY DELETE DATE HSTSYS HISTORY KEEP RECORDS Bild 3 Ablauf der Reorganisation 168 U21462 J Z125 7
585. ufl sung des Makros AVSASSCD AVSASSCD MFCHK MF C PREFIX A MACID VSI DMACID VSI SUPPORT C D DS OF PREFIX A MACID VSI AA ABLDAT CONDITION DIRECTORY DESCRIPTION AVSICDIR DS 0CL96 CONDITION DIRECTORY AVSIFCNM DS 0CL68 FULL CONDITION DESCRIPTION NAME AVSICTYS DS CL3 CONDITION TYPE STRING NET JOB RES VAL AVSICNAM DS CL30 BK_CONDITIONNAME AVSICNNM DS CL32 CREATED BY BK NET NAME AVSICIND DS CL3 CREATED BY INDEX AVSICTYP DS X COND TYPE CODE AVSICST1 DS X STATE 1 AVSICLTI DS 0602 LIFE TIME AVSICLTD DS CL6 LIFE DATE YYMMTT AVSICLTT DS CL6 LIFE TIME HHMMSS TYPE NET LIFE TIME NET NET PLAN TYPE JOB LIFE TIME JOB NET PLAN DS CL RESERVED AVSICMUS DS X MAX USING SHARE AVSICUWT DS H AITING NET COUNT AVSICUUS DS H USING NET COUNT DS CL8 RESERVED DS 06 008 U21462 J Z125 7 Programmschnittstelle von AVAS Assembler Schnittstelle AVSASSCE Bedingungseintrag in der Ablaufdatei definieren Makro Parameter AVSASSCE MF C D PREFIX A char 1 lt MACID VSB char 3 lt EQU NO YES Parameter MF und PREFIX siehe AVSASSAD auf Seite 389 MACID Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Standardwert 8 EQU Steuert die Generierung von Equates f r die Schl sselw rter N Es werden keine Equates generiert
586. ugriffsprozess ZD weiterleitet und die vom ZD empfange nen Daten an die Programme bergibt Die Kommunikation zwischen den Programmen und dem ZDI erfolgt ber eine interne Makro Schnittstelle Die Anforderungen der Programme werden ber das ZD Interface auf zwei Zugriffsprozes se verteilt Zugriffe auf Bibliotheken werden an den PLAM ZD weitergeleitet Zugriffe auf die Ablaufdatei die Journaldatei die Not Journaldatei und die Periodendatei an den UPAM ZD Der Anschluss eines Programms erfolgt an beide Zugriffsprozesse wenn es auf die von beiden ZDs verwalteten Dateien zugreifen will Deshalb haben beide ZDs Zugriff auf die System Parameter Sie geben an den anmeldenden Prozess die erforderlichen Daten aus den System Parametern weiter Wenn ein Programm nur auf eine Dateigruppe zugreift z B die Ablaufsteuerungen nur auf die Ablaufdatei und die Journale meldet es sich nur bei dem zugeordneten ZD an z B UPAM ZD Alle AVAS Dateien k nnen ab BS2000 OSD BC V1 0 als NK4 Dateien gef hrt werden siehe Handbuch Einf hrung in das DVS 6 2 2 5 1 Benutzerdateien und ihre symbolischen Namen In dieser bersicht werden die Benutzerdateien mit den symbolischen Namen gezeigt wie sie in der Muster Generierungsdatei vorgegeben sind Die Benutzerdateien enthalten die vom Benutzer erstellten Daten z B Jobs Netzbeschreibungen usw e Generierungsdatei GENPAR In dieser SAM Datei m ssen die Generierungs Parameter definiert werden die auf
587. und die Ablaufsteuerung beendet Der Fehler ist zu beheben und die Ablaufsteuerung erneut zu starten Startparameter zur Zusammenarbeit mit Server Systemen SERVER PROCEDURE NAME NONE Die Ablaufsteuerung soll keine Server Jobs unterst tzen Wenn Netze mit Server Jobs die aktiviert werden sollen gestartet werden werden die Strukturelemente mit einem Server Job w h rend der Netzbearbeitung auf ERROR gesetzt Bei SERVER PROCEDURE NAME NONE k nnen die nachfol genden Parameter entfallen dateiname Name der ENTER Prozedur die die Ablaufsteuerung zum Starten des AVAS Agenten AVSSINCM siehe Seite 463 benutzen soll Zu beachten ist dass diese Prozedur von allen Kennungen und Rechnern die durch die Ablaufsteuerung angesprochen werden erreichbar sein muss SERVER JV LINK lt name 1 8 gt Link Name im Namen der Server Jobvariablen aus der der aktuelle Status des Servers ermittelt wird bevor ein Serverjob gestartet wird Name der Server Jobvariablen AVS SERVER STATE lt server jv link name gt lt servername gt STD Wenn der Parameter nicht angegeben wird tr gt die Ablaufsteue rung den eigenen Namen ein Beim Starten der Server berwa chung ist dann deren Startparameter SERVER JV LINK mit dem Namen der Ablaufsteuerung zu versorgen siehe Seite 125 U21462 J Z125 7 119 Starten und Beenden der AVAS Prozesse Administration von AVAS SERVER PROCEDURE PASSWORD NONE Die ENTER Prozedur ist mit keinem Kennwort ges
588. ungen Benutzerhandbuch Bestellnr U22049 J Z125 3 Die oben aufgef hrte Dokumentation kann auch in englischer Sprache bezogen werden U21462 J Z125 7 3 Inhalt der AVAS Handb cher Einleitung 1 4 Inhalt der AVAS Handb cher Das Handbuch AVAS Funktionen 2 wendet sich an den AVAS Benutzer Es gibt zun chst einen berblick ber die AVAS Funktionen AnschlieBend sind die Festlegung und Abwick lung der Produktion ausf hrlich beschrieben Kurze Beschreibungen des Mehrrechnerbe triebs und der Administration runden das Handbuch ab Das Handbuch AVAS Anweisungen 1 wendet sich an den AVAS Benutzer und den AVAS Administrator Es enth lt alle AVAS Anweisungen in alphabetischer Reihenfolge Die Masken sind bei den zugeh rigen AVAS Anweisungen beschrieben Des Weiteren informiert das Handbuch ber e die Dialogf hrung e das Vorbereiten von Jobs f r den Ablauf unter AVAS und e die CHECK Funktion F r die Verwaltung des AVAS Systems steht das vorliegende Systemverwalterhandbuch AVAS f r den Administrator zur Verf gung Es beschreibt alle Aufgaben des AVAS Admi nistrators von der Generierung des Systems bis zur Administration des AVAS Systems In diesem Handbuch sind au erdem enthalten e das Dienstprogramm AVAS QUER e die Kopplung von AVAS mit MAREN e die AVAS Reports e die BATCH Funktionen e die externe Erstellung von AVAS Elementen e die Programmschnittstelle e AVAS SV und e AVAS SV BS2
589. ur die Angabe des neuen Ziel Systems durch Eintrag in der CATID f r das Netz bzw den Job in der Netzbeschreibung oder nach bereits erfolgter Freigabe in der Ablaufdatei Ablaufsteuerung und kontrolle f r Jobs mit einem externen Server F r den Start und die Kontrolle von Ablaufen auf beliebigen Server Systemen bietet AVAS eine JV Schnittstelle an Ablaufe mit Kontrolle ber eine AVAS Jobvariable werden ber Strukturelemente mit FUNCTION P und TYPE EXX gestartet Damit wird eine externe Prozedur des Benutzers gestartet Der Prozedur wird ber PROCEDURE PARAMETERS der Name der kontrollie renden AVAS Jobvariablen mitgegeben Das ordnungsgem e oder abnormale Ende des so gestarteten Ablaufs muss der Ablauf steuerung ber die festgelegten Inhalte der AVAS Jobvariablen mitgeteilt werden ber diese Schnittstelle kann die Steuerung an beliebige Prozesse im BS2000 OSD wei tergegeben werden Dieser Prozess kann entweder e selbst f r den Transport in das Server System den Start eines Jobs im Server System und die bertragung des Ergebnisses ins BS2000 OSD sorgen oder e ber eine ihm bekannte Schnittstelle im Server System Jobs starten und berwachen lassen sowie das Ergebnis an AVAS zur ckmelden U21462 J Z125 7 443 AVAS SV Plattform bergreifende Jobsteuerung Der Benutzer muss lediglich sicherstellen dass e die Jobvariable nicht gel scht wird und e das normale oder abnormale Ende des Ablaufs entsprechend der AV
590. us der Benutzermaske zur Uberpr fung bergeben RZ Exit AVEX6801 Eingaben f r Jobmasken Wenn JCL Anweisungen eines Jobs mit Hilfe einer im Job angegebenen Benutzermaske AVAS Anweisung AVM oder einer durch den Parameter FORMAT NAME zugeordneten Benutzermaske modifiziert werden k nnen den AVAS Variablen P nnn durch eine RZ Routine die aktuellen Werte der Ablauf Parameter zugeordnet werden Diese Werte bleiben bis zum n chsten Aufruf der Benutzermaske durch den Job g ltig oder bis zum Ende des Jobs Die Modifikation mit den bergebenen Werten kann direkt zugelassen oder abgebrochen werden Wenn keine weiteren Benutzereingriffe mehr notwendig sind kann auf die Dialogausgabe der Benutzermaske verzichtet werden Andernfalls wird die Benutzermaske mit den ber gebenen Werten ausgegeben Der Ausgang AVEX6801 wird aktiviert bevor eine zugeordnete Benutzermaske ausge geben wird Die RZ Routine kann die Eingaben f r die Benutzermaske zur Bearbeitung oder Ausgabe bergeben RZ Exit AVEX6802 bergabe der Werte der Maskenfelder einer Jobmaske Wenn JCL Anweisungen eines Jobs mit Hilfe einer im Job angegebenen Benutzermaske AVAS Anweisung AVM oder einer durch den Parameter FORMAT NAME zugeordneten Benutzermaske modifiziert werden werden die den AVAS Variablen P nnn zugeordneten aktuellen Werte aus der Benutzermaske der RZ Routine bergeben Die Modifikation mit den bergebenen Werten kann direkt zugelassen abgebrochen oder
591. usteines HAVJ H HAVJH Umsetzen der AVJ Anweisung in Kommando MODIFY JV f r die MONJV AVA Informationen im Journal eintragen P P symbolischer Name f r eine Variable aus Jobmasken N N symbolischer Name f r eine Variable aus Netzmasken F F symbolischer Name f r eine Variable aus der USER PARAM FILE S S symbolischer Name f r Systemvariable RA RA n chste Anweisung im Restart austauschen RI Rl Anweisung im Restart einf gen RU RU n chste Anweisung im Restart unterdr cken Wenn einem symbolischen Namen eine andere Zeichenfolge zugeordnet wird muss die vorgegebene Anzahl der Zeichen beibehalten werden Beispiel AVM MAS P J N J Es empfiehlt sich die Standard Zeichenfolgen beizubehalten da die Verarbeitung bei der Modifikation auf diese Zeichenfolgen hin optimiert ist U21462 J Z125 7 44 Installation und Generierung Generierung des AVAS Systems 2 2 3 ndern der System Parameter eines installierten AVAS Systems nderungen in der Generierungsdatei GENPAR werden im AVAS System erst wirksam wenn mit der Prozedurdatei AVS GENSYSPAR Element in der Bibliothek SYSPRC AVAS 070 eine neue AVAS System Parameterdatei erstellt wird und die zentra len Zugriffsprozesse mit dieser neuen System Parameterdatei gestartet werden Wenn in den Generierungs Parametern die AVAS SYSTEM ID geandert wird werden durch den Generierungslauf System Parameter f r ein anderes AVAS System erzeugt Beim Andern der
592. utput insert sql userid acc password 12 py Empfangs Auftrag insert sq1 07997 gestartet py Empfangs Auftrag insert sq1 07997 erfolgreich ausgef hrt sql nco nco i 244 Dienstprogramm AVAS QUER Anweisungen von AVAS QUER Prozedur starten Angabe des gew nschten Formats Name der zu erstellenden Ausgabedatei Angabe der Benutzerkennung Aufruf des Programms AVAS SYS LOAD QUER Wu Startmeldung des Programms AVAS SYS LOAD QUER Meldung zur Eingabe der Anmeldedaten Anmelden an AVAS QUER durch SIGNON Format f r die Ausgabedatei festlegen 10 Objekte ausw hlen 11 Programm AVAS QUER beenden Im Zielsystem Holen und gleichzeitiges Umbenennen der von AVAS QUER erstellten Ausgabeda tei output Im ncopy Kommando muss der Partnerrechner und die Zugangsbe rechtigung f r den Partnerrechner eingetragen werden Das Kennwort wird dabei ohne Hochkommata eingegeben Nach Beendigung des ncopy Kommandos steht im Zielsystem die Datei jetzt unter dem Namen insert sql zur Verf gung Der Suf fix sql wird von INFORMIX als Kriterium f r die Dateibearbeitung vorausgesetzt 13 Das Datenbankprogramm INFORMIX wird mit isql aufgerufen Anschlie end k n nen die datenbankspezifischen Kommandos und Anweisungen eingegeben wer den INFORMIX SQL SQL Dialog F hren eines interaktiven Dialoges mit SQL Anweisungen AUSWAHL D
593. von Jobs zentral gespeichert e Produktionsnetzbliotheken NPRLIB In diesen Bibliotheken werden die geplanten Netze gespeichert e Bibliotheken f r Produktionsjobs J MDSYS oder JMDLIB In diesen Bibliotheken werden die ablauff higen Jobs gespeichert Das sind Jobs die f r den Ablauf nicht mehr modifiziert werden F r JMDSYS und JMDLIB gilt sinngem das Gleiche das bei den Netzbibliotheken beschrieben ist e Maskenbibliotheken MAPLIB Der Benutzer muss die Maskenbibliotheken mit den FHS Maskenmodulen nach den FHS Richtlinien erstellen Eine FHS Maskenmodulbibliothek kann direkt als MAPLIB zugeordnet werden Die Unterscheidung zwischen Bibliotheken mit Masken f r die Netzmodifikation NETMAP und Bibliotheken mit Masken f r die Jobmodifikation JOBMAP erfolgt bei der Zuordnung ber die Generierungs Parameter 54 U21462 J Z125 7 Installation und Generierung Generierung des AVAS Systems Die beiden folgenden AVAS Dateien sind PAM Dateien die vor der Verwendung im AVAS System formatiert werden m ssen Die Formatierung erfolgt mit der Prozedur AVS FORM Element in der Bibliothek SYSPRC AVAS 070 Die Anzahl der Bl cke die formatiert wer den sollen ist innerhalb AVAS vorbelegt mit PRIMARY ALLOC 240 und SECOND ALLOC 30 Wenn die Dateien mit anderen Werten formatiert werden sollen k nnen diese ber das Kommando CREATE FILE vorgegeben werden Dabei ist zu beachten dass alle SPACE Angaben gegebenenfalls auf ein Vielfa
594. ware gibt es den Eintrag AVAS NT Die Umgebungsvariable AVAS_BINPATH die auf dem Programmpfad des AVAS Servers und der Dienstprogramme automatisch gesetzt ist kann als Umgebungsvariable in den Windows Jobs f r deren Aufruf verwendet werden 11 1 3 Installation von AVAS SV BS2 auf einem BS2000 System Nach der Installation eines AVAS Servers auf einem BS2000 System mit IMON m ssen unter der Benutzerkennung unter der AVSRECV gestartet werden soll folgende AVAS Bi bliotheken vorhanden sein SYSMES AVAS 070 SYSPRC AVAS 070 SYSPRG AVAS 070 SYSTEM SYSPRG AVAS SV BS2 070 Zum Starten des AVAS Servers wird die Prozedur AVS RECV aus der Bibliothek SYSPRC AVAS 070 aufgerufen In dieser Prozedur sind vorher folgende Parameter anwen derspezifisch zu versorgen CONTROL JV Name der Jobvariablen mit der der AVAS Server gesteuert wird Standardm ig vorbelegt mit SYSJV AVAS RECV COMM PW Kommunikationskennwort mit dem sich Clients am AVAS SERVER anmelden PORT Portnummer unter der der AVAS Server erreichbar ist WORKDIR Suffix Name unter dem der AVAS Server seine Arbeitsdateien ablegt USERID Benutzerkennung unter der die AVAS Bibliotheken abgelegt sind Standardm ig vorbelegt mit AVAS Parameterangabe f r die Proze dur Der AVAS Server auf dem BS2000 System wird beendet indem in die Jobvariable die un ter CONTROL JV eingetragen ist der Wert SHUTDOWN geschrieben wird U21462 J Z125 7 449 Deinstallation der AVAS Serv
595. wendet das im Beispiel im Verzeichnis opt 1ib AVAS SV bin installiert ist Zur ber gabe der LOG Datei wird das Programm avslog aufgerufen das ebenfalls in opt lib AVAS SV bin installiert ist Job BS2 EXT PRI job Start eines R 3 Jobs aus AVAS im BS2000 0SD Die zugeh rige USER PAR FILE Datei ist BS2_EXT_PRI par AVASBIN opt lib AVAS SV bin export AVASBIN AVASR3PATH home eich avas avasr3_link export AVASR3PATH AVASR3LOGFILE AVASR3PATH LOG Dateien BS2EXT PRI Y log export AVASR3LOGFILE RFC_INI AVASR3PATH saprfc ini export RFC_INI DEST BAOHELIOS USER AVAS3 AVASR3_CALL destination DEST user USER export AVASR3_CALL 506 U21462 J Z125 7 Steuerung von SAP R 3 Jobs mit AVAS Start von avasr3 AVASR3PATH avasr3 AVASR3 CALL Auswertung der Ergebnisse EENDET export ERGEBNIS B ABGEBROCHEN export ERGEBNIS B NOCH NICHT GESTARTET export ERGEBNIS B SCHON GESTARTET export ERGEBNIS RGEBNIS out AVASR3LOGFILE be be case in 0 ERGEBNIS JOB OK B BNIS RV 0 JO 1 ERGE 2 ERGEBNIS RV 0 JO 3 ERGEBNIS RV 0 JO avssinjv E avslog std esac AVASBI AVASBI AVAS SV Plattform bergreifende Jobsteuerung USER PAR FILE Datei BS2 EXT PRI par job BS2bXT PRI Y 1 15 erl x typl extern elios 2 RSPFPAR 2 GW 3 pwd typ3 extern LPO1 es 2 pri imm Y progra paramet hostl h progra variant progr
596. wendet sich an die Systemverwaltung und an erfahrene BS2000 Benutzer Inhalt Es beschreibt wie SDF mit Hilfe von SDF Kommandos und den Dienstprogrammen SDF I SDF U und SDF PAR installiert und verwaltet wird Die Anweisungen von SDF I SDF U und SDF PAR sind vollst ndig beschrieben Bestellnummer U2622 J Z125 10 U21462 J Z125 7 Literatur 13 14 544 Netze l schen 164 Reorganisation 165 Ablaufkontrolle B2000 Server 442 externe Server 524 UNIX Windows Server 441 Ablaufprotokolle verwalten 136 von Jobs 6 Ablaufsteuerung 104 bedienen 129 beenden 120 beliebiger Server 443 BS2000 Server 442 Definition 35 externe Server 524 Kennwortvergabe 114 Server Systeme 454 starten 113 Startparameter 113 UNIX Windows Server 441 Ablaufsteuerungssystem 35 527 BS2000 485 UNIX 471 Windows 477 ABLDAT 26 527 Ablaufdatei 55 ABLDUP 26 527 ADD JOB LOG BATCH Anweisung 313 Anmeldeinformation in Jobvariable 106 Anweisungen Journals tze 191 Programmschnittstelle 373 Arbeitsbereich WRKAREA 385 545 Stichw rter AVA 44 AVD 44 AVJ 44 AVM 44 HAVS 44 RA 44 RI 44 RU 44 SCR bzw SCR n bei Ausgabeb ndern 263 VOL bzw VOL n bei Eingabeb ndern 263 Berechtigung 33 INFORM PROG Kommando Bedienung der Ablaufsteuerung 129 Steuerung der Netzabl ufe 130 O Berechtigung 33 1 Berechtigung 33 A Abh ngigkeit 527 aufgel ste 527 Ablauf Job auf externem Server 524 Reorganis
597. wenn RV n nicht angegeben wurde pfixMJTL Ausgabe Parameter L nge des Inhalts der Auftrags Jobvariablen pfixMJTX Ausgabe Parameter Inhalt der Auftrags Jobvariablen In dem Bereich mit maximaler L nge wird der Inhalt in der L nge von pfixMJTL eingestellt R ckgabe der RZ Routine an AVAS Die RZ Routine muss im Feld pfixRSC des Verst ndigungsbereichs an AVAS einen Return code mit folgender Bedeutung zur ckmelden pfixOK EQU X 00 Der Jobstatus wurde zur Kenntnis genommen Wenn die RZ Routine andere Returncodes zur ckmeldet setzt AVAS eine Meldung ab die RZ Routine wird nicht erneut aufgerufen Hinweis Die Reaktion auf Jobstatus ERROR muss programmiert werden U21462 J Z125 7 89 RZ Exits im AVAS System Installation und Generierung RZ Exit AVEX2001 Wenn der Benutzer die Anweisung START EXIT eingibt ruft AVAS die RZ Routine auf bergabe von AVAS an die RZ Routine und R ckgabe der RZ Routine an AVAS Die Felder des Kommunikationsbereichs versorgt AVAS beim Aufruf der RZ Routine mit Leerzeichen pfixMSG Eingabe Parameter Meldung f r Maske AVS030 pfixOPR Eingabe Ausgabe Parameter Informationen aus dem Feld OPR die beim Aufruf von START EXIT in der AVAS Maske eingegeben wurden und nach Beendigung des RZ Exits in das Feld OPR der Maske AVS030 ausgegeben werden sollen pfixOPR1 Eingabe Ausgabe Parameter Entspricht dem Feld OPR in der Zeile 22 der AVAS Masken pfixOPR2 Eingabe Ausgabe Parameter Entspr
598. werden nicht reorganisiert Alle Protokolldaten mit Status TRANSFERRED ADDED oder IGNORE werden gesichert Diese Wertzuweisung ist Standard wenn die Funktion FUNKTION JOBLOG angegeben wurde F r andere Funktionen ist die Anweisung nicht zul ssig Nach dem Sichern erhalten die Protololldateien den Status SAVED Es werden keine Protokolle gesichert Die Anweisung ist nur zusammen mit FUNKTION JOBLOG zul ssig 177 STD YES NO U21462 J Z125 7 Reorganisation der AVAS Benutzerdateien Sicherung und Reorganisation JOBLOG SAVE LINK Die Reorganisationsanweisung legt fest wohin die Protokolle gesichert werden sollen JOBLOG SAVE LINK linkname LIB linkname linkname Dateikettungsname einer SAM Datei in die die Protokolle gesichert werden LIB linkname Dateikettungsname einer PLAM Bibliothek in die die Protokolle gesichert werden Die Bibliothek muss vom Reorganisationsprogramm aus direkt erreichbar sein siehe Seite 165 Sie kann mit der Anweisung SHOW JOB LOG in einem Revisions AVAS gelesen werden wenn sie dort als LOGSYS Bibliothek eingetragen ist NET NAME Diese Reorganisationsanweisung bestimmt die Netze die reorganisiert werden NET NAMES ALL bk netname bk b ALL Alle Netze werden bei der Reorganisation ber cksichtigt bk_netname Das angegebene Netz oder bei verk rztem Netznamen die angegebene Netzgruppe werden reorganisiert Der Benutzerkreis muss vollst ndig angegeben werden
599. wird AVS8521 DELETE PERIOD period RESULT ergebnis ausgegeben oder eine Fehlermeldung Der Wert f r period ist der Name der Periode die in der Periodendatei gel scht werden Soll U21462 J Z125 7 331 DELETE PLAN NET BATCH Anweisungen DELETE PLAN NET L schen geplanter Netze im Produktionsplan Bei DELETE PLAN NET gibt es keine Unterschiede zur Dialogfunktion Es wird empfohlen die BATCH Anweisung nur in Verbindung mit dem Parameter NET STATUS SUBMITTED oder REPEATED zu verwenden womit nur verarbeitete Netze gel scht werden DELETE PLAN NET NET NAME bk netname PERIOD NAME periog NET STATUS TOCREATE PARTIALLY CREATED NOTTOCREATE SUBMITTED REPEATED Der Parameter PERIOD NAME ist nur in Verbindung mit einem teilqualifizierten Netzna men zugelassen Protokoll der Verarbeitung F r jedes gel schte Netz wird AVS8521 DELETE PLAN NET netname RESULT ergebnis ausgegeben oder eine Fehlermeldung 332 U21462 J Z125 7 BATCH Anweisungen DELETE PROD JOB END DELETE PROD JOB L schen statischer BS2000 Jobs S Prozeduren und Server Jobs Mit DELETE PROD JOB k nnen statische BS2000 Jobs S Prozeduren und Server Jobs in der AVAS Benutzerbibliothek JMDLIB gel scht werden DELETE PROD JOB ELEMENT NAME bk element Der Parameter ELEMENT NAME muss angegeben werden der Parameterwert kann teil qualifiziert angegeben werden Protokoll der Verarbeitung F r jeden gel schten BS2000
600. wurden bei der Reorganisation gesichert OUTPUT ERROR Status LOW Alle ausgegebenen Journals tze befinden sich in der Journaldatei ERROR Wegen eines Fehlers wurden Journals tze dieses Netzes in die Not Journaldatei ausgegeben gt 10002 LO OD JO Oo 5 COO 00 2 ST Mo no x xx e DX Ze XXX XIX X 00 x 16 Programmschnittstelle von AVAS NST3 NST4 U21462 J Z125 7 Assembler Schnittstelle Programmschnittstelle von AVAS AVSASSUJN Journalsatzkopf definieren Makro Parameter AVSASSJN MF C D PREFIX A char 1 gt MACID VSP char 3 lt EQU NO YES Parameter MF und PREFIX siehe AVSASSAD auf Seite 389 MACID Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Standardwert VSP EQU Steuert die Generierung von Equates f r die Schl sselw rter N Es werden keine Equates generiert YES Es werden die Equates f r die Schl sselw rter generiert Hinweis e Der Makro AVSASSJN generiert eine Verl ngerung des Ausgabebereichs Er muss daher im Anschluss an den Makro AVSASSBO aufgerufen werden e Die schl sselabh ngigen Teile der Journals tze werden durch den Makro AVASJRN generiert Dieser muss unmittelbar nach AVSASSJN aufgerufen werden Der Makro ist im Abschnitt Datenstrukturen der Journalsicherung und der Not Journaldatei auf Seite 187 beschr
601. x NJ1A Externe programmtechnische Erstellung von Netzen 360 Externe Erstellung von AVAS Elementen Externe programmtechnische Erstellung von Netzen AVASNET RECORD J2 PREFIX N EQU YES MFCHK MF C C PREFIX N 0 MACID J2 0 DMACID J2D C SUPPORT C D DS Op JHHHHE PREFIX N MACID J2 Heike J2A DS Op J2SLEN DS H PLAM RECORD LENGTH De PLAM RESERVED PLAM SK D CG PLAM RESERVED PLAM SA 2550 DS CL2 RECORD KEY J2FUNC DS DESCRIPTION FUNCTION CODE FUNCTION J2EFUA EQU CA ADD J2EFUC EQU CC COMPARE J2EFUD EQU C D J DELET J2EFUJ EQU C J START JOB J2EFUM EQU CH MODIFY J2EF EQU C N NET J2EFUP EQU CP START PROCEDURE J2ERUS EQU C S START J2EF EQU C w WAIT J2EFUX EQU CX START SERVER JOB J2TYPE DS X DESCRIPTION TYPE CODE TYPE J2ENET EQU 33 NET J2EJVA EQU 60 JVA J2EEXT EQU 70 EXT J2EMOD EQU 71 MOD J2EEXX EQU 81 EXX J2ESTD EQU 94 0 2308 EQU 112 JOB J2ERES EQU 113 RES J2EVAL EQU 114 VAL J2ETIM EQU 115 TI DS 01 RESERVED J2IND DS 603 INDEX J2NAM DS CL30 NAME DS 02 RESERVED U21462 J Z125 7 361 Externe programmtechnische Erstellung von Netzen Externe Erstellung von AVAS Elementen START AND RESTART DESCRIPTION FIELDS USED ONLY WHEN So 7 DESRCIPTION TYPE JVA NET JOB RES VAL TIM MOD EXT EXX i li ST
602. ype AVSCCDNT CREATED BY NET netname AVSCCDNN CREATED BY INDEX index AVSCCDNI Namen in Klammern geben die Felder des Kommunikationsbereichs an in die die Parame ter geschrieben werden m ssen siehe Abschnitt Aufbau der Verst ndigungsbereiche auf Seite 380 Andere Parameterkombinationen als die oben gezeigten sind nicht zul ssig AVAS USER LIBRARY ABLDAT JRNDAT ABLDAT Es sollen Informationen aus der Ablaufdatei gelesen werden JRNDAT Es sollen Informationen aus der Journaldatei gelesen werden Der Parameter muss immer angegeben werden CONDITION NAME condname group Name des Bedingungseintrags Wenn er vollqualifiziert angegeben wird liefert die Funktion Daten der Bedingungs Parameter und der Benutzer der Bedingung Wenn er teilqualifiziert angegeben wird liefert die Funktion ein Ver zeichnis der Bedingungseintr ge die der Teilqualifikation entspre chen Wenn der Parameter nicht angegeben wird wird CONDITION NAME bk angenommen U21462 J Z125 7 377 READ AVAS LIBRARY Programmschnittstelle von AVAS CONDITION TYPE type Beschreibt den Bedingungstyp Die m glichen Bedingungstypen finden Sie bei der Anweisung ADD CONDITION DESCRIPTION im Handbuch AVAS Anweisungen 1 Wenn die Daten eines ganz bestimmten Bedingungseintrags gew nscht werden muss dieser Parameter angegeben werden da der CONDITION NAME alleine nicht eindeutig ist Die Angabe ist wahlfrei CREATED BY NET bk_ netname _date _time S
603. ystemkonsole ber INFORM PROG Komman dos e Aufrufe an die Ablaufsteuerung ber Eingaben in die Jobvariable der Ablaufsteuerung Der Name der Jobvariablen wird ber die System Parameter festgelegt Dieser Abschnitt behandelt die INFORM PROG Kommandos Bei diesen wird unterschie den zwischen e Eingaben f r die Ablaufsteuerung selbst e Eingaben zur Steuerung der Netze die unter der Kontrolle der Ablaufsteuerung ablau fen e Eingabe zum Aktualisieren der AVAS Rechnertabelle Eingaben f r die Ablaufsteuerung INFORM PROG CANCEL Abbrechen der Ablaufsteuerung und kontrolle INFORM PROG HOLD Anhalten der Ablaufsteuerung und kontrolle INFORM PROG NETC Durchf hren der Netzstartkontrolle INFORM PROG RUNC Durchf hren der Abbruchkontrolle laufender Netze INFORM PROG RESUME Reaktivieren der Ablaufsteuerung und kontrolle INFORM PROG STOP Beenden der Ablaufsteuerung und kontrolle Die Kommandos sind im Handbuch AVAS Anweisungen 1 beschrieben U21462 J Z125 7 129 Bedienen und berwachen der AVAS Prozesse Administration von AVAS Steuern freigegebener Netze ber INFORM PROG Gegenstand dieses Abschnitts sind die Funktionen die den Ablauf und die Kontrolle der Netze und Jobs unterst tzen Die INFORM PROG Kommandos zur Steuerung des Ablaufes von Netzen sollten nur ver wendet werden wenn kein Dialogterminal zum Administrieren des Ablaufes zur Verf gung steht oder wenn das Dialogsystem nicht
604. zeintrag f r Journal 418 U21462 J Z125 7 Cobol Schnittstelle AVSCOBAD Netzverzeichniseintrag Ablaufdatei AVSCOBAN Netzbeschreibungseintrag AVSCOBCD Ereignisverzeichniseintrag AVSCOBCE Ereignisbeschreibung Die Felder der COPY Elemente haben die gleichen Namen wie die Assemblerdefinitio nen Sie sind im Abschnitt Aufbau der Verst ndigungsbereiche auf Seite 380 beschrieben Programmbeispiel in Cobol Programmschnittstelle von AVAS 10 4 1 Dieses Beispiel zeigt die programmtechnische Ausf hrung der Anweisungen SIGNON SUBMIT NET und END Die Fehlerbehandlung ist lediglich angedeutet ION DIVISION HARACTERS COPY AVSCOBBO AVSCOBOL DIVISION IDENTIFICAT PROGRAM ID ENV I RONMENT CONFIGURATION SECTION SPECIAL NAMES SYMBOLIC C gt POINT FOR END OF SPECIAL NAMES DATA DIVISION WORKING STORAGE SECTION 77 ASSIGN SIGNON PICTURE X VALUE AVSA SIGNON 77 ASSIGN END PICTURE X VALUE AVSA END 77 ASSIGN SUBMIT PICTURE X VALUE AVSA SUBMIT NET 77 USER ID PICTURE X 08 VALUE TEST s 77 PASSWORD PICTURE X 08 VALUE TEST e 77 SYSTEM ID PICTURE X 07 VALUE SYSIDAV 77 NET NAME PICTURE X 32 VALUE TEST NET 7 7 MAX RESULT COUNTER PICTURE 9 4 COMPUTATIONAL VALUE 20 COPY AVSCOBBC COPY AVSCOBBO 06 FILLER OCCURS 20 TIMES COPY AVSCOBRT COPY AVSCOBBW REPLACING COUNT BY O PROCEDURE DIVISION CALL AVAS FOR SIGNON MOVE LOW VALUE TO AVSCAREA MOVE AVASA SIGNON T
605. zeugt wobei jedes Feld und jedes Equate benannt sind Diese Daten struktur wird Teil des aktuellen Programmabschnitts CSECT DSECT D Erzeugt das Layout der Datenstruktur wie bei MF C zus tzlich wird ein DSECT Statement erzeugt PREFIX Der Parameter PREFIX dient zur Generierung der zu erzeugenden Namen PREFIX der genau ein Buchstabe ist wird als erster Buchstabe aller Na men verwendet Standardwert ist der Kennbuchstabe der Funktionseinheit dem der Makro angeh rt Um Namensgleichheit zu vermeiden ist PREFIX zu verwenden wenn dieselbe Datenstruktur mehrfach innerhalb eines Moduls verwendet wird MACID Der Parameter MACID dient zur Generierung der zu erzeugenden Namen Die 3 Zeichen lange Zeichenfolge bestimmt das zweite bis vierte Zeichen des Namens Der Standardwert VSD garantiert die Kollisionsfreiheit der Namen innerhalb der Komponentengruppe 389 U21462 J Z125 7 Assembler Schnittstelle Programmschnittstelle von AVAS EQU Steuert die Generierung von Equates f r die Schl sselfelder NO Es werden keine Equates generiert YES Es werden Equates generiert Hinweis Der Makro AVSASSAD generiert eine Verl ngerung des Ausgabebereichs Er muss daher im Anschluss an den Makro AVSASSBO aufgerufen werden Aufl sung des Makros AVSASSAD AVSASSAD MFCHK MF C PREFIX A MACID VSD DMACID VSD SUPPORT C D DS Op AHHHHE PREFIX A MACID VSD Hier
606. zu keiner Verarbeitung Die zugeordneten K F Tasten sind im laufenden AVAS Betrieb nicht zu ver ndern F r die folgenden Operationen sind die Werte K1 bis K15 oder F1 bis F24 zugelassen z B DEFAULT OPERATION PLUS K1 DEFAULT OPERATION PLUS DEFAULT OPERATION MINUS DEFAULT OPERATION EXECUTE DEFAULT OPERATION RETURN DEFAULT OPERATION SAVE DEFAULT OPERATION CONTINUE DEFAULT OPERATION PRINT DEFAULT OPERATION FIRST DEFAULT OPERATION LAST DEFAULT OPERATION IGNORE DEFAULT OPERATION DOCUMENT DEFAULT OPERATION HELP DEFAULT OPERATION JOBLOG DEFAULT OPERATION CHECK DEFAULT OPERATION VISIBLE Hinweis Zu beachten ist dass bei den K Tasten keine Daten sondern nur Kurzinformationen zum Rechner bertragen werden Ein ndern der Daten mit der Operation SAVE ist also mit einer K Taste nicht m glich U21462 J Z125 7 37 Generierung des AVAS Systems Installation und Generierung Definition f r die bersichtsverarbeitung DEFAULT MARK YES YES NO YES In allen Auswahlmasken muss ein Element markiert werden Wenn kein Element markiert wird wird nach der Operation EXECUTE die Meldung AVS5005 KEIN OBJEKT FUER VERARBEITUNG AUSGEWAEHLT angezeigt NO Das Markieren eines Elementes ist nicht notwendig Wenn kein Element markiert wird werden bei der Operation EXECUTE alle Elemente intern mit Y markiert und verarbeitet Hinweise Bei COPY ELEMENT COPY SYSTEM ELEMENT CREATE PLAN NET und CREATE PROD NET wird der
607. zus tzlich zur Beendigung aller Sekund rtasks Hier ist nach dem Beheben der Fehlerursache ein kompletter Start des CENTRAL Prozesses erforderlich Das gleiche Verhalten ist gegeben wenn mit einem BS2000 Systemkommando ein CENTRAL Prozess hart beendet wird Starten des SIGNAL Programms Das Programm SIGNAL muss in einem AVAS Job geladen werden und ben tigt eine Auf trags Jobvariable Es ermittelt alle Informationen f r eine Protokoll bernahme und sendet diese an den CENTRAL Prozess Ein mehrfacher Aufruf von SIGNAL ist innerhalb eines Jobablaufs zul ssig wobei jedoch die mehrfache Meldung desselben Protokollnamens zu einem Fehler f hrt Die Protokoll Datens tze der ersten signalisierten Datei eines Jobab laufs sind in den Funktionen SHOW NET STATUS oder SHOW JOURNAL f r eine Anzeige aufrufbar Das Programm SIGNAL wird durch Aufruf der Prozedur AVS SIGNAL Element der Biblio thek SYSPRC AVAS 070 gestartet oder innerhalb eines AVAS Jobs mit einer selbst erstell ten Prozedur oder Kommandofolge ber SYSDTA k nnen folgende Parameter zur Steuerung des Ablaufs vorgegeben werden APPLICATION ptnname proname jobvariable ptnname proname ptnname ist der Applikationsname des CENTRAL Prozesses proname ist der Prozessorname des CENTRAL Prozesses jobvariable Der Applikationsname des CENTRAL Prozesses steht ab Stelle 1 der Prozessorname ab Stelle 9 der angegebenen Jobvariablen Der Parameter APPLICATION muss angegeben werd

Download Pdf Manuals

image

Related Search

Related Contents

  取扱説明書 - 三星ダイヤモンド工業  MANUEL D`UTILISATION T1  Euro-Pro KP300 User's Manual    Samsung SGH-P300 Felhasználói kézikönyv  

Copyright © All rights reserved.
Failed to retrieve file