NetBatch Management Programming Manual

ManualsBrandsHP ManualsServerHP NonStop G-Series

NetBatch Management

Programming Manual

Abstract

This manual describes the Distributed Systems Management (DSM) programmatic

interfaces (commands, responses, and event messages in Subsystem Programmatic

Interface [SPI] format) to the NetBatch subsystem.

Product Version

NetBatch D30.00

Supported Release Version Updates (RVUs)

This publication supports D20.00 and all subsequent D-series RVUs, G02.00 and all

subsequent G-series RVUs, and H06.03 and all subsequent H-series RVUs until

otherwise indicated by its replacement publication.

Part Number Published

522462-003 September 2005

Summary of content (470 pages)

PAGE 1
NetBatch Management Programming Manual Abstract This manual describes the Distributed Systems Management (DSM) programmatic interfaces (commands, responses, and event messages in Subsystem Programmatic Interface [SPI] format) to the NetBatch subsystem. Product Version NetBatch D30.00 Supported Release Version Updates (RVUs) This publication supports D20.00 and all subsequent D-series RVUs, G02.00 and all subsequent G-series RVUs, and H06.
PAGE 2
Document History Part Number Product Version Published 522462-001 NetBatch D30 February 2002 522462-002 NetBatch D30 May 2002 522462-003 NetBatch D30 September 2005
PAGE 3
NetBatch Management Programming Manual Glossary Index Examples Figures Tables What’s New in This Manual xi Manual Information xi New and Changed Information xi Changes to the G06.16 Manual xi Changes to the G06.15 Manual xii Previous Changes xii About This Manual xvii Audience xvii Prerequisites xvii Organization xvii Further Reading xviii Notation Conventions xix Abbreviations xxiii 1.
PAGE 4
2. Communicating With the NetBatch Subsystem (continued) Contents 2. Communicating With the NetBatch Subsystem (continued) Opening a Scheduler Programmatically 2-4 Closing a Scheduler 2-5 Stopping a Scheduler 2-6 Running an EMS Consumer Distributor 2-6 3.
PAGE 5
4. Common Definitions (continued) Contents 4. Common Definitions (continued) Predefined Token and Field Values 4-35 Simple Tokens 4-40 Extensible Structured Tokens 4-49 5.
PAGE 6
5. Commands and Responses (continued) Contents 5. Commands and Responses (continued) STATUS ATTACHMENT-SET Command 5-53 STATUS EXECUTOR Command 5-55 STATUS JOB Command 5-56 STATUS SCHEDULER Command 5-58 STOP EXECUTOR Command 5-60 STOP JOB Command 5-61 SUBMIT JOB Command 5-63 SUSPEND JOB Command 5-67 SWITCHCPU SCHEDULER Command 5-69 SWITCHLOG SCHEDULER Command 5-70 6.
PAGE 7
Contents A. Error Numbers and Error Lists (continued) A.
PAGE 8
Contents A. Error Numbers and Error Lists (continued) A.
PAGE 9
Contents A. Error Numbers and Error Lists (continued) A.
PAGE 10
Contents A. Error Numbers and Error Lists (continued) A.
PAGE 11
A. Error Numbers and Error Lists (continued) Contents A. Error Numbers and Error Lists (continued) 2234 ZBAT-ERR-EMS A-108 2235 ZBAT-ERR-PFS A-108 B. Token Codes and Token Maps NetBatch Token Codes and Token Types B-2 NetBatch Token Maps and DDL Definitions B-5 C. Sample Programs Sample C Program C-2 Sample COBOL Program C-15 Sample TACL Macros C-30 Sample TAL Program C-41 Glossary Index Examples Example 7-1. Example 7-2. Example 7-3. Example C-1. Example C-2. Example C-3. Example C-4.
PAGE 12
Tables (continued) Contents Tables (continued) Table 4-7. Table 4-8. Table 4-9. Table 4-10. Table 4-11. Table 4-12. Table 4-13. Table 5-1. Table 5-2. Table 5-3. Table 5-4. Table 5-5. Table 6-1. Table 6-2. Table B-1. Table B-2.
PAGE 13
What’s New in This Manual Manual Information NetBatch Management Programming Manual Abstract This manual describes the Distributed Systems Management (DSM) programmatic interfaces (commands, responses, and event messages in Subsystem Programmatic Interface [SPI] format) to the NetBatch subsystem. Product Version NetBatch D30.00 Supported Release Version Updates (RVUs) This publication supports D20.00 and all subsequent D-series RVUs, G02.00 and all subsequent G-series RVUs, and H06.
PAGE 14
New and Changed Information What’s New in This Manual Changes to the G06.15 Manual • • Added new event messages to Section 6, Event Messages. Added new NetBatch error codes to Appendix A, Error Numbers and Error Lists.
PAGE 15
New and Changed Information What’s New in This Manual The D30 programmatic interfaces introduce new job-selection tokens and support wildcard character matching in these commands: ACTIVATE JOB ALTER JOB DELETE JOB INFO JOB RUNNEXT JOB RUNNOW JOB STOP JOB SUBMIT JOB SUSPEND JOB The D30 programmatic interfaces introduce new job-attribute tokens and extend the ZBAT-MAP-DEF-JOB and ZBAT-MAP-DEF-WAITON tokens in these commands: ALTER JOB INFO JOB SUBMIT JOB New Private Token and Field Types The D30 progr
PAGE 16
New and Changed Information What’s New in This Manual New Predefined Token and Field Values The D30 programmatic interfaces introduce these new predefined token and field values: ZBAT-VAL-EMS-ERROR ZBAT-VAL-EMS-OFF ZBAT-VAL-EMS-ON ZBAT-VAL-EVENT ZBAT-VAL-EXECUTING ZBAT-VAL-FIRST-LIST ZBAT-VAL-LAST-LIST ZBAT-VAL-READY ZBAT-VAL-RUNNEXT ZBAT-VAL-RUNNOW ZBAT-VAL-SCHEDULER-ZNOTSTARTED ZBAT-VAL-SCHEDULER-ZSHUTDOWN ZBAT-VAL-TAPE ZBAT-VAL-TIME ZBAT-VAL-WAITON-SET ZBAT-VAL-SCHEDULER-ZSTARTED ZBAT-VAL-SPECIAL-1 ZB
PAGE 17
What’s New in This Manual New and Changed Information New Errors and Warnings The D30 programmatic interfaces introduce these new errors and warnings (that is, new ZBAT-DDL-RETCODE values): ZBAT-ENM-E-CRONTAB (value is 2218) ZBAT-ENM-E-DESCRIPTION (value is 2227) ZBAT-ENM-E-EMS (value is 2234) ZBAT-ENM-E-EVERY-CATCHUP (value is 2233) ZBAT-ENM-E-HIGHPIN (value is 2220) ZBAT-ENM-E-JOBID-ZERO (value is 2224) ZBAT-ENM-E-MAXCONCURRENTJOBS (value is 2231) ZBAT-ENM-E-MAXPRI (value is 2230) ZBAT-ENM-E-MAXTEMPEXEC
PAGE 18
What’s New in This Manual New and Changed Information NetBatch Management Programming Manual—522462-003 xvi
PAGE 19
About This Manual This manual describes the Distributed Systems Management (DSM) programmatic interfaces (commands, responses, and event messages in Subsystem Programmatic Interface (SPI) format) to the NetBatch subsystem.
PAGE 20
Further Reading About This Manual Section Description Section 5, Commands and Responses Describes the syntax and semantics of all NetBatch programmatic commands and the responses to those commands. Section 6, Event Messages Describes the EMS event messages that the NetBatch subsystem can issue and the specific programming considerations for dealing with these event messages in an application.
PAGE 21
Notation Conventions About This Manual Section Description Safeguard Reference Manual Describes the Safeguard distributed security management facility and the syntax of the commands of the SAFECOM command interpreter. SPI Programming Manual Describes the Subsystem Programmatic Interface (SPI) and explains how to use it in management applications and subsystems you write.
PAGE 22
General Syntax Notation About This Manual [ ] Brackets. Brackets enclose optional syntax items. For example: TERM [\system-name.]$terminal-name INT[ERRUPTS] A group of items enclosed in brackets is a list from which you can choose one item or none. The items in the list may be arranged either vertically, with aligned brackets on each side of the list, or horizontally, enclosed in a pair of brackets and separated by vertical lines. For example: FC [ num ] [ -num ] [ text ] K [ X | D ] address { } Braces.
PAGE 23
Notation for Messages About This Manual Item Spacing. Spaces shown between items are required unless one of the items is a punctuation symbol such as a parenthesis or a comma. For example: CALL STEPMOM ( process-id ) ; If there is no space between two items, spaces are not permitted. In these example, there are no spaces permitted between the period and any other items: $process-name.#su-name Line Spacing.
PAGE 24
Notation for Messages About This Manual Bold Text. Bold text in an example indicates user input entered at the terminal. For example: ENTER RUN CODE ?123 CODE RECEIVED: 123.00 The user must press the Return key after typing the input. Nonitalic text. Nonitalic letters, numbers, and punctuation indicate text that is displayed or returned exactly as shown. For example: Backup Up. lowercase italic letters. Lowercase italic letters indicate variable items whose values are displayed or returned.
PAGE 25
Change Bar Notation About This Manual % Percent Sign. A percent sign precedes a number that is not in decimal notation. The % notation precedes an octal number. The %B notation precedes a binary number. The %H notation precedes a hexadecimal number. For example: %005400 %B101111 %H2F P=%p-register E=%e-register Change Bar Notation Change bars are used to indicate substantive differences between this edition of the manual and the preceding edition.
PAGE 26
Abbreviations About This Manual NetBatch Management Programming Manual—522462-003 xxiv
PAGE 27
1 Introduction This section introduces NetBatch: Topic Page NetBatch Subsystem Description 1-2 NetBatch Programmatic Interfaces 1-3 Objects Managed by the NetBatch Subsystem 1-5 Supported Object-Management Functions 1-5 Interactive Commands and Corresponding Programmatic Commands 1-6 NetBatch Management Programming Manual—522462-003 1 -1
PAGE 28
NetBatch Subsystem Description Introduction NetBatch Subsystem Description The NetBatch subsystem lets your organization automate job scheduling, startup, and management on NonStop systems.
PAGE 29
Introduction NetBatch Programmatic Interfaces NetBatch Programmatic Interfaces The NetBatch subsystem’s SPI-compatible programmatic interfaces enable your applications to: • • Send commands to and receive responses from the subsystem in the form of tokenized messages Retrieve events sent by the subsystem in the form of tokenized messages For general information about SPI and EMS, see the SPI Programming Manual and the EMS Manual.
PAGE 30
NetBatch Programmatic Interfaces Introduction Figure 1-1. NetBatch Subsystem Input file Scheduler Database Input file BATCHCOM BATCHCAL NetBatch-Plus Calendar file NETBATCH EMS Management application SPI Scheduler and job log files EMS Management application NB^JOB^SUBMIT Any executor program Input file output file Input file NBEXEC Input file TACL Process Process Process Process output file Process output file Process VST001.
PAGE 31
Objects Managed by the NetBatch Subsystem Introduction Objects Managed by the NetBatch Subsystem These objects are managed by the NetBatch subsystem: • • • • • An attachment set is a named set of ASSIGNs, DEFINEs, and PARAMs. A class is a logical entity in the scheduler. A class’s purpose is to group jobs and to control their flow to executors and thereby to the executors’ processors. An executor is a logical entity in the scheduler.
PAGE 32
Interactive Commands and Corresponding Programmatic Commands Introduction Interactive Commands and Corresponding Programmatic Commands Table 1-1 lists the interactive (BATCHCOM) commands that control NetBatch objects and the corresponding programmatic commands and object types. For details of the programmatic commands, see Section 5, Commands and Responses. Table 1-1.
PAGE 33
Interactive Commands and Corresponding Programmatic Commands Introduction Table 1-1.
PAGE 34
Introduction Interactive Commands and Corresponding Programmatic Commands NetBatch Management Programming Manual—522462-003 1 -8
PAGE 35
2 Communicating With the NetBatch Subsystem This section explains how to set up communication between a management application and the NetBatch subsystem: Topic Page Steps in Communicating With the NetBatch Subsystem 2-1 Starting a Scheduler 2-2 Opening a Scheduler 2-3 Closing a Scheduler 2-5 Stopping a Scheduler 2-6 Running an EMS Consumer Distributor 2-6 Steps in Communicating With the NetBatch Subsystem Figure 2-1 summarizes the procedure your application must follow when communicating with
PAGE 36
Starting a Scheduler Communicating With the NetBatch Subsystem Figure 2-1. Steps in Communicating With the NetBatch Subsystem Application 1. NetBatch Scheduler Open the scheduler. 2. Build and send a command message. 3. Receive and decode the commandmessage response. Receive and interpret the command message. Execute the command and return a response. 4. Close the scheduler. VST002.
PAGE 37
Communicating With the NetBatch Subsystem Starting a Scheduler Programmatically For detailed information on the procedures, see the NetBatch Manual. Starting a Scheduler Programmatically To start a scheduler programmatically, use the Guardian procedure, PROCESS_CREATE_ to run the scheduler program NETBATCH. When NETBATCH is running, use the programmatic commands ADD SCHEDULER (cold starts only) and START SCHEDULER (cold starts and warm starts) to make the scheduler available for use.
PAGE 38
Communicating With the NetBatch Subsystem Opening a Scheduler Programmatically example, a RUN BATCHCOM command. These examples show explicit and implicit OPEN commands: OPEN Command Examples Explicit > BATCHCOM BATCHCOM - T9190D30 - (31OCT94^01JUN94) (C)1986 Tandem (C)2004 Hewlett Packard Development Company, L.P.
PAGE 39
Communicating With the NetBatch Subsystem Closing a Scheduler When your application opens the scheduler, it must check for file-system errors in addition to the errors listed in Table 2-1. For information on file-system errors, see the Guardian Procedure Calls Reference Manual. Table 2-1. Open Errors for the Scheduler Error Cause, Effect, and Recovery 11 File or device does not exist Cause. The scheduler did not recognize the process-name qualifier because the qualifier name was not #ZSPI. Effect.
PAGE 40
Communicating With the NetBatch Subsystem Stopping a Scheduler Stopping a Scheduler The NetBatch subsystem provides the ABORT SCHEDULER and SHUTDOWN SCHEDULER commands for stopping schedulers: Command Function ABORT SCHEDULER Stops all executing and suspended processes associated with jobs, then stops the scheduler. SHUTDOWN SCHEDULER Stops suspended processes associated with jobs, then stops the scheduler after allowing all executing processes associated with jobs to finish.
PAGE 41
3 SPI Programming Considerations for the NetBatch Subsystem The SPI Programming Manual provides general instructions for formatting commands and decoding responses and event messages for subsystems such as the NetBatch subsystem.
PAGE 42
SPI Programming Considerations for the NetBatch Subsystem Definition Files Definition Files The commands, responses, and event messages sent to and received from the NetBatch subsystem consist of items called tokens. Each token contains a particular piece of information, such as a command parameter or a detail of an event. Tokens can be single values or structures consisting of several values. Some tokens, called header tokens, are present in every command and response and in every event message.
PAGE 43
SPI Programming Considerations for the NetBatch Subsystem Event-Message Template For example, a management application written in TAL that sends commands to the NetBatch subsystem and retrieves event messages issued by that subsystem requires these SOURCE statements: ?SOURCE $vol.ZSPIDEF.ZBATTAL ?SOURCE $vol.ZSPIDEF.ZEMSTAL ?SOURCE $vol.ZSPIDEF.
PAGE 44
SPI Programming Considerations for the NetBatch Subsystem Message Elements for the NetBatch Subsystem Message Elements for the NetBatch Subsystem This subsection provides subsystem-specific information about elements of NetBatch commands, responses, and event messages. For information on these elements, descriptions of elements whose meaning is not subsystem-specific (such as the subsystem ID), and SPI tokens and other definitions, see the SPI Programming Manual.
PAGE 45
SPI Programming Considerations for the NetBatch Subsystem Subjects of Event Messages of the form ZBAT-EVT-name, where name identifies the event. For example, the event reporting that a job started is represented by the name ZBAT-EVT-JOB-START. In NetBatch event messages, the event-number header token (ZEMS-TKNEVENTNUMBER) can assume any of the set of NetBatch event numbers. For descriptions of NetBatch event messages, see Section 6, Event Messages.
PAGE 46
SPI Programming Considerations for the NetBatch Subsystem Discontinuing a Command in Progress Caution. An extensible structured token in a command must always be initialized by SSNULL. Using SSNULL to initialize an extensible structured token ensures every field of the token is initialized to its null value. This action is important because an operation will be performed if a field contains a value other than its null value.
PAGE 47
SPI Programming Considerations for the NetBatch Subsystem Receiving and Decoding a Response Message Receiving and Decoding a Response Message To receive and decode a response message from the NetBatch subsystem: 1. Declare a buffer of appropriate size.
PAGE 48
SPI Programming Considerations for the NetBatch Subsystem Version Compatibility Version Compatibility Versions of the NetBatch subsystem that support SPI and EMS are: SPI NetBatch D21 and later EMS NetBatch D20 and later To ensure upward compatibility between your applications and later versions of the NetBatch subsystem, the applications must comply with the SPI and EMS programming guidelines in the SPI Programming Manual and the EMS Manual.
PAGE 49
SPI Programming Considerations for the NetBatch Subsystem • Displaying SPI Traffic Use the BATCHCOM command DISPLAY-SPI. The command makes BATCHCOM display the contents of each command buffer sent and each response buffer received. For more information, see the NetBatch Manual.
PAGE 50
SPI Programming Considerations for the NetBatch Subsystem Displaying SPI Traffic VAR indicates the token is a variable-length token. The size of the token’s value in bytes is given in size:token-value. size is the token size in bytes (when size appears in token-data-type:size) or the size of the token’s value in bytes (when size appears in size:tokenvalue). size appears with token-data-type when the token is not a variablelength token.
PAGE 51
SPI Programming Considerations for the NetBatch Subsystem Displaying SPI Traffic If the value includes printable and unprintable characters, or is unprintable, the display format is: bytes: ? [ count x ] binary-value [ ? [ count x ] binary-value ]… [ printable-chars ]… bytes is the number of bytes in the value. count specifies the number of occurrences of binary-value. count appears only when binary-value occurs more than once. binary-value is the binary value of the character (not necessarily a space).
PAGE 52
SPI Programming Considerations for the NetBatch Subsystem • Displaying SPI Traffic If the type is DATALIST, ENDLIST, or ERRLIST, then DATALIST, END LIST, or ERROR LIST appears as appropriate with details of the tokens in the list.
PAGE 53
SPI Programming Considerations for the NetBatch Subsystem Retrieving and Decoding Event Messages Retrieving and Decoding Event Messages For detailed information on event-message retrieval and decoding, and for examples of event-message retrieval in the C, COBOL, TACL, and TAL languages, see the EMS Manual. To retrieve and decode event messages from the NetBatch subsystem: 1. Declare a buffer of appropriate size for the EMS GETEVENT command and its response.
PAGE 54
SPI Programming Considerations for the NetBatch Subsystem Critical Events SUBJECT) to get the token code and index of the token identifying the subject. Then make another call to retrieve the subject token itself. g. Call procedure EMSGET or EMSGETTKN to retrieve the values of other tokens from the event message. h. Take action appropriate to the information in the event message. For information on retrieving tokens from an event message, see the EMS Manual.
PAGE 55
4 Common Definitions This section discusses SPI standard definitions, EMS standard definitions, and NetBatch definitions used in the token-oriented programmatic interfaces to the NetBatch subsystem: Topic Page SPI Standard Definitions 4-2 EMS Standard Definitions 4-6 NetBatch Definitions 4-8 This section provides general information that applies to all uses of the definitions in the interfaces to the NetBatch subsystem.
PAGE 56
SPI Standard Definitions Common Definitions SPI Standard Definitions Definitions whose names begin with ZSPI- are SPI standard definitions. These definitions, which are available to all subsystems that support SPI procedures, are found in the ZSPIDEF.ZSPIDDL file and in the corresponding files for other languages. Table 4-1 through Table 4-6 list the SPI standard definitions used in the NetBatch subsystem’s programmatic interfaces.
PAGE 57
SPI Standard Definitions Common Definitions Table 4-3. SPI Standard Definitions for Special Tokens ZSPI-TKN-ADDR ZSPI-TKN-INITIAL-POSITION ZSPI-TKN-CLEARERR ZSPI-TKN-LEN ZSPI-TKN-COUNT ZSPI-TKN-NEXTCODE ZSPI-TKN-DATA-FLUSH ZSPI-TKN-NEXTTOKEN ZSPI-TKN-DEFAULT-SSID ZSPI-TKN-OFFSET ZSPI-TKN-DELETE ZSPI-TKN-RESET-BUFFER Table 4-4.
PAGE 58
Information About SPI Standard Definitions Specific to the NetBatch Subsystem Common Definitions Information About SPI Standard Definitions Specific to the NetBatch Subsystem The SPI Programming Manual fully describes all SPI standard definitions. Information about the definitions that is specific to the NetBatch subsystem is: ZSPI-SSN-ZBAT is the NetBatch subsystem number (9). ZSPI-TKN-COMMAND contains a command number of a NetBatch command.
PAGE 59
Information About SPI Standard Definitions Specific to the NetBatch Subsystem Common Definitions ZSPI-TKN-RETCODE is the return token that the NetBatch subsystem returns in a response message. If the token contains a value other than zero, an error occurred. In this circumstance, the message also contains an error list describing the error. ZSPI-TKN-SERVER-BANNER contains the server-banner string for the NetBatch subsystem and is returned only for the GETVERSION command.
PAGE 60
EMS Standard Definitions Common Definitions EMS Standard Definitions Definitions whose names begin with ZEMS- are EMS standard definitions. These definitions, which are available to all subsystems that support EMS, are found in the ZSPIDEF.ZEMSDDL file and in the corresponding files for other languages. Table 4-7 and Table 4-8 list the EMS standard definitions used in the NetBatch subsystem’s programmatic interfaces.
PAGE 61
NetBatch-Specific Information About EMS Standard Definitions Common Definitions ZEMS-TKN-EMPHASIS specifies whether an event is critical (as defined in the EMS Manual).
PAGE 62
NetBatch Definitions Common Definitions NetBatch Definitions Definitions whose names begin with ZBAT- are NetBatch definitions. They are found in file ZSPIDEF.ZBATDDL and in the corresponding files for other languages. Table 4-9 through Table 4-13 list NetBatch definitions.
PAGE 63
NetBatch Definitions Common Definitions Table 4-10. NetBatch Private Token and Field Types (page 2 of 2) ZBAT-DDL-PAR-RELEASE-JOB ZBAT-TYP-PC-ERROR0 ZBAT-DDL-PC-ERROR0 ZBAT-TYP-PC-ERROR1 ZBAT-DDL-PC-ERROR1 ZBAT-TYP-REASON ZBAT-DDL-REASON ZBAT-TYP-RETCODE Table 4-11.
PAGE 64
NetBatch Definitions Common Definitions Table 4-11. NetBatch Token Predefined Token and Field Values (page 2 of 2) ZBAT-VAL-JOB-TIME-LIST ZBAT-VAL-WAITON-STOP ZBAT-VAL-LAST-LIST ZBAT-VAL-WAITON-STOPABEND ZBAT-VAL-NEWPROCESS-ERROR ZBAT-VAL-WAS-RUNNING Table 4-12.
PAGE 65
NetBatch Definitions Common Definitions Table 4-12. NetBatch Simple Tokens (page 2 of 2) ZBAT-TKN-RETCODE ZBAT-TKN-TIME-LIMIT ZBAT-TKN-SCHEDULER-ID ZBAT-TKN-TOTAL-CPU-TIME ZBAT-TKN-SEL-ADPNAME ZBAT-TKN-USERID ZBAT-TKN-SEL-ASSIGN-NAME ZBAT-TKN-VOLUME-SUBVOL Table 4-13.
PAGE 66
NetBatch Buffer Declarations Common Definitions NetBatch Buffer Declarations The NetBatch subsystem provides these buffer declarations for message buffers you can use with the SPI procedures. All applications must use one of these declarations for a buffer of the recommended size. ZBAT-DDL-MSG-BUFFER is a message buffer of the size recommended for commands, responses, and event messages. It has the structure: Definition ZBAT-DDL-MSG-BUFFER.
PAGE 67
Private Token and Field Types Common Definitions Private Token and Field Types A private token is a token defined and used exclusively by the subsystem that defines it. These paragraphs describe the private token and field types defined by the NetBatch subsystem: ZBAT-DDL-COMMAND is an enumerated value that specifies a command.
PAGE 68
Private Token and Field Types Common Definitions ZBAT-DDL-COMPLETION-CODE is an enumerated value that indicates the completion code set by a job’s executorprogram process when the process calls the Guardian procedure ABEND, STOP, or PROCESS_STOP_.
PAGE 69
Private Token and Field Types Common Definitions ZBAT-DDL-DEF-JOB defines ZBAT-MAP-DEF-JOB, an extensible structured token that contains information about a job. For the structure of ZBAT-DDL-DEF-JOB, see the description of ZBAT-MAP-DEF-JOB in Extensible Structured Tokens on page 4-49. ZBAT-DDL-DEF-SCHEDULER defines ZBAT-MAP-DEF-SCHEDULER, an extensible structured token that contains information about a scheduler.
PAGE 70
Private Token and Field Types Common Definitions ZBAT-DDL-EXECUTOR-LIST is an enumerated value that indicates an executor’s state. It has the structure: Definition ZBAT-DDL-EXECUTOR-LIST 89 ZBAT-ENM-EXECUTOR-OFF-LIST 89 ZBAT-ENM-EXECUTOR-ON-LIST 89 ZBAT-ENM-EXECUTOR-ACTIVE-LIST 89 ZBAT-ENM-EXECUTOR-STOP-LIST 89 ZBAT-ENM-EXECUTOR-DOWN-LIST 89 ZBAT-ENM-EXECUTOR-DELETE-LIST Begin Type Enum AS "Unknown". Value is ZBAT-VAL-EXECUTOR-OFF-LIST As "OFF-LIST ". Value is ZBAT-VAL-EXECUTOR-ON-LIST As "ON-LIST ".
PAGE 71
Private Token and Field Types Common Definitions ZBAT-DDL-JOB-WHICH-LIST is an enumerated value that indicates a job’s state in the ZINFO-WHICH-LIST field of ZBAT-MAP-DEF-JOB and in the ZWHICH-LIST field of ZBAT-MAP-STATUSJOB.
PAGE 72
Private Token and Field Types Common Definitions ZBAT-DDL-LIST is an enumerated value that indicates a job’s state in ZBAT-TKN-SEL-LIST.
PAGE 73
Private Token and Field Types Common Definitions ZBAT-DDL-OBJECT is an enumerated value that specifies an object type. It has the structure: Definition ZBAT-DDL-OBJECT 89 ZBAT-ENM-ATT-SET 89 ZBAT-ENM-OBJECT-EXECUTOR 89 ZBAT-ENM-OBJECT-JOB 89 ZBAT-ENM-OBJECT-CLASS 89 ZBAT-ENM-OBJECT-SCHEDULER Begin Type Enum AS "Unknown". Value is ZBAT-OBJ-ATT-SET As "ATTACHMENT SET". Value is ZBAT-OBJ-EXECUTOR As "EXECUTOR OBJECT". Value is ZBAT-OBJ-JOB As "JOB OBJECT". Value is ZBAT-OBJ-CLASS As "CLASS OBJECT".
PAGE 74
Private Token and Field Types Common Definitions ZBAT-DDL-PC-ERROR0 is an enumerated value returned in event message ZBAT-EVT-JOB-STARTERROR. The value indicates the error returned to the scheduler by Guardian procedure PROCESS_CREATE_. For descriptions of ZBAT-DDL-PC-ERROR0 values, see the explanation of ZBAT-EVT-JOB-START-ERROR in Section 6, Event Messages.
PAGE 75
Private Token and Field Types Common Definitions 89 ZBAT-ENM-PCERR-LIBCONF 89 ZBAT-ENM-PCERR-PROGEQLIB 89 ZBAT-ENM-PCERR-ILLSUBTYPE 89 ZBAT-ENM-PCERR-BACSUBTYPE 89 ZBAT-ENM-PCERR-BACCREATEUN 89 ZBAT-ENM-PCERR-CONTEXTERR 89 ZBAT-ENM-PCERR-BADPFSSIZE 89 ZBAT-ENM-PCERR-UNKNOWN-C Value is 18 As "Library conflict". Value is 19 As "Program file and library file are same". Value is 20 As "process device subtype illegal". Value is 21 As "Backup/Primary have different device subtypes".
PAGE 76
Private Token and Field Types Common Definitions ZBAT-DDL-PC-ERROR1 is an enumerated value returned in event message ZBAT-EVT-JOB-STARTERROR. The value indicates the cause of the error for ZBAT-DDL-PC-ERROR0 values ZBAT-ENM-PCERR-ILLLIB and ZBAT-ENM-PCERR-ILLPROG. For descriptions of ZBAT-DDL-PC-ERROR1 values, see the explanation of ZBAT-EVTJOB-START-ERROR in Section 6, Event Messages.
PAGE 77
Private Token and Field Types Common Definitions ZBAT-DDL-REASON is an enumerated value returned in event message ZBAT-EVT-JOB-STARTERROR. The value indicates why the scheduler was unable to start a job’s executor-program process. For descriptions of ZBAT-DDL-REASON values, see the explanation of ZBAT-EVT-JOB-START-ERROR in Section 6, Event Messages.
PAGE 78
Private Token and Field Types Common Definitions ZBAT-DDL-RETCODE is an enumerated value that indicates an error number. The standard SPI error token ZSPI-TKN-ERROR returns the error number in an error list. For descriptions of NetBatch error numbers and their associated error lists, see Appendix A, Error Numbers and Error Lists.
PAGE 79
Private Token and Field Types Common Definitions 89 ZBAT-ENM-W-RUNNOW-TAPE 89 ZBAT-ENM-I-NO-SUCH-CMD 89 ZBAT-ENM-W-DISALLOW-DEFINE 89 ZBAT-ENM-W-WAITON-NOT-ANY 89 ZBAT-ENM-W-SAME-SYSTEM 89 ZBAT-ENM-W-WAITON-THIS-JOB 89 ZBAT-ENM-W-DEFAULT-SUBV-UNSUP 89 ZBAT-ENM-W-SWITCHCPU-DEFERRED 89 ZBAT-ENM-E-BEGIN 89 ZBAT-ENM-E-ACTIVATE-JOB 89 ZBAT-ENM-E-AFTER 89 ZBAT-ENM-E-AFTER-YEAR 89 ZBAT-ENM-E-AFTER-MONTH 89 ZBAT-ENM-E-AFTER-DAY 89 ZBAT-ENM-E-AFTER-HOUR 89 ZBAT-ENM-E-AFTER-MINUTE 89 ZBAT-ENM-E-ALREADY-STARTED 89 Z
PAGE 80
Private Token and Field Types Common Definitions 89 ZBAT-ENM-E-HOLDAFTER 89 ZBAT-ENM-E-NO-CPU 89 ZBAT-ENM-E-DELETE-JOB 89 ZBAT-ENM-E-EVERY-ZERO-MINUTES 89 ZBAT-ENM-E-EVERY 89 ZBAT-ENM-E-EVERY-CAL-CRON 89 ZBAT-ENM-E-EXECUTOR-PROG 89 ZBAT-ENM-E-EXECUTOR-ACTIVE 89 ZBAT-ENM-E-EXECUTOR-NOT-ACTIVE 89 ZBAT-ENM-E-WAITON-SELF 89 ZBAT-ENM-E-EXECUTOR-EXISTS 89 ZBAT-ENM-E-NO-SUCH-EXECUTOR 89 ZBAT-ENM-E-EXECUTOR-FULL 89 ZBAT-ENM-E-EXTRA-TOKEN 89 ZBAT-ENM-E-HOLD 89 ZBAT-ENM-E-IFFAILS 89 ZBAT-ENM-E-IN 89 ZBAT-ENM-E-IN-R
PAGE 81
Private Token and Field Types Common Definitions 89 ZBAT-ENM-E-MAXPRINTLINES 89 ZBAT-ENM-E-MAXPRINTPAGES 89 ZBAT-ENM-E-NO-SUCH-EXECUTOR 89 ZBAT-ENM-E-EXECUTOR-FULL 89 ZBAT-ENM-E-EXTRA-TOKEN 89 ZBAT-ENM-E-HOLD 89 ZBAT-ENM-E-IFFAILS 89 ZBAT-ENM-E-IN 89 ZBAT-ENM-E-IN-REQUIRED 89 ZBAT-ENM-E-INITIATION 89 ZBAT-ENM-E-USER-UNDEFINED 89 ZBAT-ENM-E-JOB-FULL 89 ZBAT-ENM-E-NO-SUCH-JOB 89 ZBAT-ENM-E-CLASS-EXISTS 89 ZBAT-ENM-E-CLASS-FULL 89 ZBAT-ENM-E-CLASS-IN-USE 89 ZBAT-ENM-E-NO-SUCH-CLASS 89 ZBAT-ENM-E-JOBNAME 89 Z
PAGE 82
Private Token and Field Types Common Definitions 89 ZBAT-ENM-E-NO-SUBMIT 89 ZBAT-ENM-E-INVALID-COMMAND 89 ZBAT-ENM-E-NONE-ALLOWED 89 ZBAT-ENM-E-NOT-STARTED 89 ZBAT-ENM-E-SECURITY 89 ZBAT-ENM-E-SHUTDOWN 89 ZBAT-ENM-E-OUT 89 ZBAT-ENM-E-PRI 89 ZBAT-ENM-E-RESTART 89 ZBAT-ENM-E-STOP-ON-ABEND 89 ZBAT-ENM-E-RUNNEXT 89 ZBAT-ENM-E-RUNNEXT-RUNNOW 89 ZBAT-ENM-E-SWITCHLOG-EDIT 89 ZBAT-ENM-E-SELPRI 89 ZBAT-ENM-E-STARTUP-MESSAGE 89 ZBAT-ENM-E-STOP-JOB 89 ZBAT-ENM-E-SUBMIT-ALLOWED 89 ZBAT-ENM-E-SUSPEND-JOB 89 ZBAT-ENM-E
PAGE 83
Private Token and Field Types Common Definitions 89 ZBAT-ENM-E-SWITCHCPU 89 ZBAT-ENM-E-LOGFILE 89 ZBAT-ENM-E-NOT-C20-FILE 89 ZBAT-ENM-E-DST 89 ZBAT-ENM-E-ATT-EXISTS 89 ZBAT-ENM-E-ATT-DNE 89 ZBAT-ENM-E-ATT-JOB 89 ZBAT-ENM-E-ATT-REQUESTOR 89 ZBAT-ENM-E-ATT 89 ZBAT-ENM-E-ATT-ERR 89 ZBAT-ENM-E-ATT-OVERFLOW 89 ZBAT-ENM-E-ATT-UPDATE 89 ZBAT-ENM-E-JOB-MULTIPLE-ATT 89 ZBAT-ENM-E-INTERNAL-ERROR 89 ZBAT-ENM-E-FILE-ERROR 89 ZBAT-ENM-E-NETBATCH-ID 89 ZBAT-ENM-E-NOT-IMPLEMENTED 89 ZBAT-ENM-E-INVALID-SPI 89 ZBAT-ENM-E-
PAGE 84
Private Token and Field Types Common Definitions 89 ZBAT-ENM-E-ATT-PARAM 89 ZBAT-ENM-E-JOB-DUPL-ATT 89 ZBAT-ENM-E-AFTER-SECOND 89 ZBAT-ENM-E-AFTER-MILLISEC 89 ZBAT-ENM-E-AFTER-MICROSEC 89 ZBAT-ENM-E-CLASS-NAME 89 ZBAT-ENM-E-WAITON-ID 89 ZBAT-ENM-E-EXECUTOR-NAME 89 ZBAT-ENM-E-CLASS-INITIATION 89 ZBAT-ENM-E-VAR-BUF-FULL 89 ZBAT-ENM-E-CRONTAB 89 ZBAT-ENM-E-PURGE-IN-FILE 89 ZBAT-ENM-E-HIGHPIN 89 ZBAT-ENM-E-POSIX 89 ZBAT-ENM-E-SAVEABEND 89 ZBAT-ENM-E-RUND 89 ZBAT-ENM-E-JOBID-ZERO 89 ZBAT-ENM-E-MEM 89 ZBAT-ENM-
PAGE 85
Private Token and Field Types Common Definitions ZBAT-DDL-SCHEDULER-STATE is an enumerated value that indicates a scheduler’s state. It has the structure: Definition ZBAT-DDL-SCHEDULER-STATE 89 ZBAT-ENM-SCHEDULER-ZNOTSTARTED 89 ZBAT-ENM-SCHEDULER-ZSTARTED 89 ZBAT-ENM-SCHEDULER-ZSHUTDOWN Begin Type Enum AS "Unknown". Value is ZBAT-VAL-SCHEDULER-ZNOTSTARTED As "Scheduler not started". Value is ZBAT-VAL-SCHEDULER-ZSTARTED As "Scheduler started".
PAGE 86
Private Token and Field Types Common Definitions ZBAT-DDL-STATUS-EXECUTOR defines ZBAT-MAP-STATUS-EXECUTOR, an extensible structured token that contains executor status information. For the structure of ZBAT-DDL-STATUSEXECUTOR, see the description of ZBAT-MAP-STATUS-EXECUTOR in Extensible Structured Tokens on page 4-49. ZBAT-DDL-STATUS-JOB defines ZBAT-MAP-STATUS-JOB, an extensible structured token containing job status information.
PAGE 87
Private Token and Field Types Common Definitions ZBAT-TYP-CHAR6 is the token type of ZBAT-TKN-CHAR6 and is defined by the structure ZSPI-DDLCHAR6 described in the SPI Programming Manual. For a description of ZBATTKN-CHAR6, see Simple Tokens on page 4-40. ZBAT-TYP-COMMAND is the token type of ZBAT-TKN-COMMAND and is defined by the structure ZBATDDL-COMMAND on page 4-13. For a description of ZBAT-TKN-COMMAND, see Simple Tokens on page 4-40.
PAGE 88
Private Token and Field Types Common Definitions ZBAT-TYP-PC-ERROR0 is the token type of ZBAT-TKN-PC-ERROR0 and is defined by the structure ZBATDDL-PC-ERROR0 on page 4-20. For a description of ZBAT-TKN-PC-ERROR0, see Simple Tokens on page 4-40. ZBAT-TYP-PC-ERROR1 is the token type of ZBAT-TKN-PC-ERROR1 and is defined by the structure ZBATDDL-PC-ERROR1 on page 4-22. For a description of ZBAT-TKN-PC-ERROR1, see Simple Tokens on page 4-40.
PAGE 89
Predefined Token and Field Values Common Definitions Predefined Token and Field Values A predefined token or field is a token or field that has a symbolic name in the NetBatch definitions file. The NetBatch subsystem defines these token and field values: ZBAT-VAL-BUFLEN is the recommended buffer size in bytes for commands sent to the NetBatch subsystem. ZBAT-VAL-BUFLEN-MAX is the maximum buffer size in bytes for commands sent to the NetBatch subsystem.
PAGE 90
Predefined Token and Field Values Common Definitions ZBAT-VAL-EXECUTOR-DELETE-LIST indicates an executor is in the DELETE state. ZBAT-VAL-EXECUTOR-DOWN-LIST indicates an executor is in the DOWN state. ZBAT-VAL-EXECUTOR-OFF-LIST indicates an executor is in the OFF state. ZBAT-VAL-EXECUTOR-ON-LIST indicates an executor is in the ON state. ZBAT-VAL-EXECUTOR-STOP-LIST indicates an executor is in the STOP state. ZBAT-VAL-EXTERNAL-SSID is the NetBatch subsystem ID defined as a string; for example, TANDEM.9.
PAGE 91
Predefined Token and Field Values Common Definitions ZBAT-VAL-JOB-RUNNOW-LIST indicates a job is in the RUNNOW state. ZBAT-VAL-JOB-SPECIAL-LIST indicates a job is in the SPECIAL state specified by the ZINFO-SPECIAL-REASON field of ZBAT-MAP-DEF-JOB. ZBAT-VAL-JOB-SUSPENDED-LIST indicates a job is in the SUSPENDED state. ZBAT-VAL-JOB-TAPE-LIST indicates a job is in the TAPE state. ZBAT-VAL-JOB-TIME-LIST indicates a job is in the TIME state.
PAGE 92
Predefined Token and Field Values Common Definitions ZBAT-VAL-SCHEDULER-ZNOTSTARTED indicates the scheduler’s primary process is running, but the backup process is not running. To create the backup process, use the START SCHEDULER command. ZBAT-VAL-SCHEDULER-ZSHUTDOWN indicates the scheduler is shutting down. ZBAT-VAL-SCHEDULER-ZSTARTED indicates the scheduler’s primary and backup processes are running. ZBAT-VAL-SPECIAL-1 indicates the SPECIAL-1 job state.
PAGE 93
Predefined Token and Field Values Common Definitions ZBAT-VAL-SSID is the subsystem ID of the NetBatch subsystem. For information on the structure of ZBAT-VAL-SSID, see ZSPI-TKN-SSID on page 4-5. ZBAT-VAL-STALL indicates a job is in the SPECIAL-9 state (the job has the attribute STALL ON and failed while running). ZBAT-VAL-SUSPENDED indicates the SUSPENDED job state. ZBAT-VAL-TAPE indicates the TAPE job state. ZBAT-VAL-TIME indicates the TIME job state.
PAGE 94
Simple Tokens Common Definitions ZBAT-VAL-WAS-RUNNING indicates a job is in the SPECIAL-2 state (the job was running when an event other than execution of an ABORT SCHEDULER or SHUTDOWN SCHEDULER command stopped its scheduler’s processes). Simple Tokens A simple token has a value consisting of a single field or a fixed structure. The NetBatch subsystem defines these simple tokens: ZBAT-TKN-ATT-SET-ASSIGN contains a string that specifies the value of an ASSIGN attachment-set attribute.
PAGE 95
Simple Tokens Common Definitions The field parameters in the preceding message format comprises numparams records of the form (offsets are given in bytes): param[0] param[1] FOR n param[n+1] param[n+2] FOR v = = = = length n, in bytes, of parameter-name parameter-name length v, in bytes, of parameter-value parameter-value ZBAT-TKN-ATT-SET-SECURITY contains a 16-bit signed integer that specifies the value of an attachment set’s SECURITY attribute.
PAGE 96
Simple Tokens Common Definitions ZBAT-TKN-CALENDAR contains the name of a BATCHCAL file that specifies a job’s run times. ZBAT-TKNCALENDAR, ZBAT-MAP-DEF-CRONTAB, and the ZEVERY-DAYS, ZEVERYHOURS, and ZEVERY-MINUTES fields of ZBAT-MAP-DEF-JOB are mutually exclusive. ZBAT-TKN-CHAR6 contains a string of six ASCII characters, also addressable as three integers or six individual characters. ZBAT-TKN-COMMAND contains an enumerated value that specifies a NetBatch command.
PAGE 97
Simple Tokens Common Definitions ZBAT-TKN-INT contains a 16-bit signed integer. ZBAT-TKN-INT2 contains a 32-bit signed integer. ZBAT-TKN-JOB-ID contains a string that specifies the owner and name of a job using an attachment set. The form of the string is (group-name.user-name)job-name, where group-name.user-name specifies the owner’s Guardian user ID and job-name the name of the job. ZBAT-TKN-JOB-NAME-ID contains a job name. ZBAT-TKN-JOB-NUMBER contains a job number.
PAGE 98
Simple Tokens Common Definitions ZBAT-TKN-PC-ERROR0 contains an enumerated value returned in event message ZBAT-EVT-JOB-STARTERROR. The value indicates the error returned to the scheduler by Guardian procedure PROCESS_CREATE_. For a list of the possible values, see the description of ZBAT-DDL-PC-ERROR0 on page 4-20. For descriptions of the values, see the explanation of ZBAT-EVT-JOB-START-ERROR in Section 6, Event Messages.
PAGE 99
Simple Tokens Common Definitions ZBAT-TKN-SEL-ADPNAME contains a string that specifies an attachment-set name. ZBAT-TKN-SEL-ASSIGN-NAME contains a string that specifies an ASSIGN name or, when the string includes either or both of the asterisk (*) and question mark (?) wild-card characters, a range of ASSIGN names.
PAGE 100
Simple Tokens Common Definitions ZBAT-TKN-SEL-JOBNAME contains a variable-length string that specifies a job name or, when the string includes either or both the asterisk (*) and question mark (?) wild-card characters, a range of job names. For information on the form of a job name, see the descriptions of the ACTIVATE, ALTER, DELETE, INFO, RUNNEXT, RUNNOW, STATUS, STOP, SUBMIT, and SUSPEND job commands in Section 5, Commands and Responses.
PAGE 101
Simple Tokens Common Definitions ZBAT-TKN-SEL-NOTUSERNAME contains a string that specifies a user ID or, when the string includes either or both the asterisk (*) and question mark (?) wild-card characters, a range of user IDs. The user ID can be in group-name.user-name or group-ID,user-ID form. ZBAT-TKN-SEL-NOTWAITON contains a string that specifies a master-job name or, when the string includes either or both the asterisk (*) and question mark (?) wild-card characters, a range of master-job names.
PAGE 102
Simple Tokens Common Definitions ZBAT-TKN-TERMINATION-INFO contains an SPI error number set by a job’s executor-program process when the process calls the Guardian procedure ABEND, STOP, or PROCESS_STOP_. The number indicates why the process stopped itself. For information about SPI error numbers, see the SPI Programming Manual. ZBAT-TKN-TEXT contains a text string from the process-deletion system message sent to a job’s executor-program process by Guardian procedure ABEND, STOP, or PROCESS_STOP_.
PAGE 103
Extensible Structured Tokens Common Definitions Extensible Structured Tokens An extensible structured token has a token map and a value consisting of data fields whose number can be extended. This extensibility lets HP add new fields to the structure in later releases. Extensible structured tokens are defined by token maps. The NetBatch subsystem defines these extensible structured tokens: ZBAT-MAP-DEF-CLASS is an extensible structured token that contains information about a class.
PAGE 104
Extensible Structured Tokens Common Definitions ZBAT-MAP-DEF-CRONTAB has the structure: Definition ZBAT-DDL-DEF-CRONTAB. 02 ZMINUTES 02 ZHOURS 02 ZDAYS 02 ZMONTHS 02 ZWEEKDAYS End Type Type Type Type Type ZSPI-DDL-INT4. ZSPI-DDL-INT2. ZSPI-DDL-INT2. ZSPI-DDL-INT. ZSPI-DDL-INT. ZMINUTES is a 64-bit fixed-point number with a bit set to 1 for each minute in an hour that the job is to run. Bits 0 through 59 represent minutes 0 through 59. Bits 60 through 63 are fillers.
PAGE 105
Extensible Structured Tokens Common Definitions ZBAT-MAP-DEF-EXECUTOR has the structure: Definition ZBAT-DDL-DEF-EXECUTOR. 02 ZCPU 02 ZJOBNUMBER 02 ZCLASS-COUNT 02 ZCLASSES 03 ZCLASSNAME 03 FILLER 02 ZCLASS End Type ZSPI-DDL-INT. Type ZSPI-DDL-INT. Type ZSPI-DDL-INT. Occurs 8 times. Type ZBAT-DDL-NETBATCH-NAME. Type ZSPI-DDL-INT. Type ZBAT-DDL-NETBATCH-NAME. ZCPU specifies the executor’s processor attribute. ZCPU can specify any processor configured for the scheduler’s node.
PAGE 106
Extensible Structured Tokens Common Definitions Command STOP JOB SUBMIT JOB SUSPEND JOB ZBAT-MAP-DEF-JOB (continued) Not used Required in command buffer Not used ZBAT-MAP-DEF-JOB has the structure: Definition ZBAT-DDL-DEF-JOB.
PAGE 107
Extensible Structured Tokens Common Definitions ZCLASSNAME is the name of a class and specifies the job’s CLASS attribute. The default value is the class specified by the scheduler’s DEFAULT-CLASS attribute. ZHOLD is a Boolean field that specifies the job’s HOLD attribute. The values are: ZSPI-VAL-FALSE ZSPI-VAL-TRUE Specifies HOLD OFF Specifies HOLD ON. The default value is ZSPI-VAL-FALSE. ZHOLD-AFTER is a Boolean field that specifies the job’s HOLDAFTER attribute.
PAGE 108
Extensible Structured Tokens Common Definitions ZIFFAILS is a Boolean field that specifies the job’s IFFAILS attribute. The values are: ZSPI-VAL-FALSE ZSPI-VAL-TRUE Specifies IFFAILS OFF Specifies IFFAILS ON The default value is ZSPI-VAL-FALSE. ZPURGE-IN-FILE is a Boolean field that specifies the job’s PURGE-IN-FILE attribute. The values are: ZSPI-VAL-FALSE ZSPI-VAL-TRUE Specifies PURGE-IN-FILE OFF Specifies PURGE-IN-FILE ON The default value is ZSPI-VAL-FALSE.
PAGE 109
Extensible Structured Tokens Common Definitions ZREMID is a Boolean field that indicates whether the job was submitted from a requester on the same node as the scheduler or from a remote node. The values are: ZSPI-VAL-FALSE ZSPI-VAL-TRUE Indicates the job was submitted from a requester on the same node as the scheduler. For a job to run as a local process, the submitter must have local access to the scheduler’s node.
PAGE 110
Extensible Structured Tokens Common Definitions ID code can be one of: 0 1 2 4 5 6 7 Any user (local) Member of owner’s group (local) Owner (local) Any user (local or remote) Member of owner’s community (local or remote) Owner (local or remote) Super ID only (local) ZPRI specifies the job’s PRI attribute. The range is 1 through 199. The default value is the value of the scheduler’s DEFAULT-PRI attribute. ZSELPRI specifies the job’s SELPRI attribute. The range is 0 through 7.
PAGE 111
Extensible Structured Tokens Common Definitions ZYEAR is an integer specifying the Gregorian year. The range is the current year minus one to the year 2525. ZMONTH is an integer specifying the Gregorian month of ZYEAR. The range is 1 through 12. ZDAY is an integer specifying the Gregorian day of ZMONTH. The range is 1 through 31. ZTIME specifies the time on ZDATE when the job becomes eligible for execution. If ZTIME is present, all its fields must be specified. If omitted, the current time applies.
PAGE 112
Extensible Structured Tokens Common Definitions ZSAVEABEND is a Boolean field that specifies the job’s SAVEABEND attribute. The values are: ZSPI-VAL-FALSE ZSPI-VAL-TRUE Specifies SAVEABEND OFF Specifies SAVEABEND ON The default value is the value of the executor program’s saveabend flag (set when compiling or binding the program). ZRUND is a Boolean field that specifies the job’s RUND attribute.
PAGE 113
Extensible Structured Tokens Common Definitions ZINFO−LAST−MODUSER is the user ID of the last user to alter the job. ZTIME−LIMIT specifies the job’s LIMIT attribute. The range is 0 through 999 hours and 0 through 59 minutes. The default value is 0 hours and 0 minutes. ZBAT-MAP-DEF-SCHEDULER is an extensible structured token that contains information about a scheduler.
PAGE 114
Extensible Structured Tokens Common Definitions BACKUPCPU attribute. The default value of ZBACKUPCPU2 when cold starting the scheduler is *. ZBACKUPCPU1 specifies the first processor preference for the scheduler’s backup process. ZBACKUPCPU1, with ZBACKUPCPU2, specifies the scheduler’s BACKUPCPU attribute. The default value of ZBACKUPCPU1 when cold starting the scheduler is the processor of the scheduler’s primary process. ZMAXCONCURRENTJOBS specifies the concurrent-jobs limit for the scheduler.
PAGE 115
Extensible Structured Tokens Common Definitions ZSUBMIT-ALLOWED is a Boolean field that specifies the scheduler’s SUBMIT-ALLOWED attribute. The values are: ZSPI-VAL-FALSE ZSPI-VAL-TRUE Specifies SUBMIT-ALLOWED OFF Specifies SUBMIT-ALLOWED ON The default value when cold starting the scheduler is ZSPI-VAL-TRUE. ZEVERY-CATCHUP is a Boolean field that specifies the scheduler’s CATCHUP attribute.
PAGE 116
Extensible Structured Tokens Common Definitions ZSTOP-ON-ABEND is a Boolean field that specifies the scheduler’s DEFAULT-STOP-ON-ABEND attribute. The values are: ZSPI-VAL-FALSE ZSPI-VAL-TRUE Specifies DEFAULT-STOP-ON-ABEND OFF Specifies DEFAULT-STOP-ON-ABEND ON The default value when cold starting the scheduler is ZSPI-VAL-FALSE. ZSTALL is a Boolean field that specifies the scheduler’s DEFAULT-STALL attribute.
PAGE 117
Extensible Structured Tokens Common Definitions Command ACTIVATE JOB ALTER JOB DELETE JOB INFO JOB RELEASE JOB RUNNEXT JOB RUNNOW JOB STATUS JOB STOP JOB SUBMIT JOB SUSPEND JOB ZBAT-MAP-DEF-WAITON Not used Optional in command buffer Not used Returned in response buffer Not used Not used Not used Not used Not used Optional in command buffer Not used ZBAT-MAP-DEF-WAITON has the structure: Definition ZBAT-DDL-DEF-WAITON. 02 ZMASTER 02 ZINDICATOR 02 ZFOR End Type ZBAT-DDL-NETBATCH-NAME.
PAGE 118
Extensible Structured Tokens Common Definitions ZBAT-MAP-DEFINE-ERROR has the structure: Definition ZBAT-DDL-DEFINE-ERROR. 02 ZNAMELEN 02 ZNAMETXT 02 ZERR 02 ZATTRLEN 02 ZATTRTXT 02 ZCLASSLEN 02 ZCLASSTXT 02 ZCHECKNUM 02 ZADDR End Type Type Type Type Type Type Type Type Type ZSPI-DDL-INT. ZSPI−DDL−CHAR24. ZSPI-DDL-INT. ZSPI-DDL-INT. ZSPI-DDL-CHAR16. ZSPI-DDL-INT. ZSPI-DDL-CHAR16. ZSPI-DDL-INT. ZSPI-DDL-INT. ZNAMELEN is the number of characters returned in ZNAMETXT.
PAGE 119
Extensible Structured Tokens Common Definitions ZBAT-MAP-PAR-RELEASE-JOB is an extensible structured token that a master job uses to release one or more of its dependents.
PAGE 120
Extensible Structured Tokens Common Definitions ZBAT-MAP-STATUS-EXECUTOR has the structure: Definition ZBAT-DDL-STATUS-EXECUTOR. 02 ZCPU 02 ZJOBNUMBER 02 ZWHICH-LIST 02 ZCLASS End Type Type Type Type ZSPI-DDL-INT. ZSPI-DDL-INT. ZBAT-DDL-EXECUTOR-LIST. ZBAT-DDL-NETBATCH-NAME. ZCPU is the number of the executor’s processor. ZJOBNUMBER is the number of the job using the executor. ZWHICH-LIST is an enumerated value of ZBAT-DDL-EXECUTOR-LIST that indicates the executor’s state.
PAGE 121
Extensible Structured Tokens Common Definitions ZBAT-MAP-STATUS-JOB has the structure: Definition ZBAT-DDL-STATUS-JOB. 02 ZOUT-SPOOL-NUM 02 ZSELPRI 02 ZOPEN-ACCESSOR-DETAIL.
PAGE 122
Extensible Structured Tokens Common Definitions ZCLASSNAME is the name of the job’s class. ZWHICH-LIST is an enumerated value of ZBAT-DDL-JOB-WHICH-LIST that indicates the job’s state.See ZBAT-DDL-JOB-WHICH-LIST on page 4-17. ZSPECIAL-REASON is an enumerated value of ZBAT-DDL-SPECIAL-REASON that qualifies the job’s state when ZWHICH-LIST indicates the job is in a SPECIAL state. See ZBAT-DDL-SPECIAL-REASON on page 4-31. ZNEXT-RUNTIME indicates the job’s next run time in Greenwich-mean-time form.
PAGE 123
Extensible Structured Tokens Common Definitions ZEXECPHANDLE is the process handle of the job’s executor-program process. ZTIME−ELAPSEDMAX indicates, in microseconds, the time taken by the longest run of the job. ZTIME−CPUMAX indicates, in microseconds, the processor time taken by all processes of the longest run of the job. ZTIME−ELAPSEDTOTAL indicates, in microseconds, the total time taken by all runs of the job.
PAGE 124
Extensible Structured Tokens Common Definitions Command STATUS SCHEDULER SWITCHCPU SCHEDULER SWITCHLOG SCHEDULER ZBAT-MAP-STATUS-SCHEDULER Returned in response buffer Not used Not used ZBAT-MAP-STATUS-SCHEDULER has the structure: Definition ZBAT-DDL-STATUS-SCHEDULER. 02 ZSTATE Type 02 ZEXECUTOR. 03 ZOFF Type 03 ZON Type 03 ZACTIVE Type 03 ZSTOP Type 03 ZDOWN Type 03 ZDELETE Type 02 ZJOB.
PAGE 125
Extensible Structured Tokens Common Definitions ZSTOP is the number of executors in the STOP state. ZDOWN is the number of executors in the DOWN state. ZDELETE is the number of executors in the DELETE state. ZJOB indicates the number of jobs in each job state. The fields are: ZREADY is the number of jobs in the READY state. ZEXECUTING is the number of jobs in the EXECUTING and OVER LIMIT states. ZSPECIAL is the number of jobs in the SPECIAL state. ZTIME is the number of jobs in the TIME state.
PAGE 126
Extensible Structured Tokens Common Definitions ZJOBCLASS indicates the number of classes with the attribute INITIATION OFF and the number of classes with the attribute INITIATION ON. The fields are: ZOFF is the number of classes whose INITIATION attribute is set to OFF. ZON is the number of classes whose INITIATION attribute is set to ON. ZPROCESS indicates the number of active and suspended job processes. The fields are: ZACTIVE is the number of active job processes.
PAGE 127
Extensible Structured Tokens Common Definitions ZSUBMIT-ALLOWED is a Boolean field that indicates the value of the scheduler’s SUBMITALLOWED attribute.
PAGE 128
Common Definitions Extensible Structured Tokens NetBatch Management Programming Manual—522462-003 4- 74
PAGE 129
5 Commands and Responses This section describes the syntax and semantics of all NetBatch programmatic commands and the responses to those commands. The command descriptions appear in alphabetic order. For each command, the section gives: • • • The command name A command description A box containing: ° ° The symbolic names of the command and the object on which it operates. Lists of the tokens that can be present in the command and response buffers.
PAGE 130
Available Commands Commands and Responses ° Operational notes stating which users can issue the command and any applicable programming considerations. Preceding the Command Descriptions on page 5-9 are: Topic Page Available Commands 5-2 Symbolic Names of Commands and Objects 5-3 Sensitive and Nonsensitive Commands 5-5 Wild-Card Characters 5-8 In this section, command numbers, object types, tokens, and token values appear in DDL format. Definitions of structures use DDL definition statements.
PAGE 131
Symbolic Names of Commands and Objects Commands and Responses Table 5-1.
PAGE 132
Symbolic Names of Commands and Objects Commands and Responses Table 5-2.
PAGE 133
Sensitive and Nonsensitive Commands Commands and Responses Sensitive and Nonsensitive Commands A command’s classification depends on its impact on the subsystem and on the security required to use it. There are two types of programmatic NetBatch command: • • Sensitive commands affect the configuration or state of objects and are usually available only to NetBatch supervisors (users with execute access to the NETBATCH program file).
PAGE 134
Sensitive and Nonsensitive Commands Commands and Responses Table 5-3. Sensitive and Nonsensitive Programmatic NetBatch Commands (page 2 of 4) Command Sensitive ALTER JOB X Nonsensitive Availability All users, but these conditions apply: • • You can alter all attributes of a job if the job has a disk input file to which you have write access, or the job’s input file is a device or a process or does not exist and you are the job’s owner.
PAGE 135
Sensitive and Nonsensitive Commands Commands and Responses Table 5-3. Sensitive and Nonsensitive Programmatic NetBatch Commands (page 3 of 4) Command Sensitive Nonsensitive Availability INFO ATTACHMENT-SET X All users, but you must have read access to an attachment set to return more than the set’s SECURITY and TEMPORARY attributes. INFO CLASS X All users. INFO EXECUTOR X All users. INFO JOB X All users. INFO SCHEDULER X All users. RELEASE JOB X All users.
PAGE 136
Wild-Card Characters Commands and Responses Table 5-3. Sensitive and Nonsensitive Programmatic NetBatch Commands (page 4 of 4) Command Sensitive SUSPEND JOB X Nonsensitive Availability All users, but these conditions apply: • • NetBatch supervisors can suspend jobs belonging to any user. Non-NetBatch supervisors can suspend any job whose input file is a disk file to which they have write access.
PAGE 137
Commands and Responses Characters Matched by Wild-Card Characters Characters Matched by Wild-Card Characters Wild-card characters: * Match zero or more characters. For example, A*D matches character strings beginning with A and ending in D (such as ABCD and AD, but not CAD or ADE). You can use multiple asterisks as long as you separate them by at least one other character. For example, *CD* matches strings containing CD (such as ABCDEF, XYZCD, and CD21, but not BC3D or DCA).
PAGE 138
ACTIVATE JOB Command Commands and Responses ACTIVATE JOB Command The ACTIVATE JOB command reactivates suspended processes associated with a job.
PAGE 139
Commands and Responses ACTIVATE JOB Command Operational Notes • • The ACTIVATE JOB command is a sensitive command. It is available to all users, but these conditions apply: ° You can reactivate any job belonging to any user if you are a NetBatch supervisor. ° You can reactivate any job whose input file is a disk file to which you have write access whether or not you are a NetBatch supervisor.
PAGE 140
ADD ATTACHMENT-SET Command Commands and Responses ADD ATTACHMENT-SET Command The ADD ATTACHMENT-SET command adds an attachment set to a scheduler.
PAGE 141
Commands and Responses ADD ATTACHMENT-SET Command ZBAT-TKN-VOLUME-SUBVOL specifies the default node, volume, and subvolume used for qualifying unqualified file references in ZBAT-TKN-ATT-SET-DEFINE. To avoid unpredictable file-name expansion when your application omits ZBAT-TKN-VOLUME-SUBVOL, fully qualify all file names in ZBAT-TKN-ATT-SET-DEFINE. Tokens in Response Buffer For information on the tokens present in the response buffer, see Section 4, Common Definitions.
PAGE 142
ADD CLASS Command Commands and Responses ADD CLASS Command The ADD CLASS command adds a class to a scheduler. Command ZBAT-CMD-ADD Object Type ZBAT-OBJ-CLASS Tokens in Command Buffer ZBAT-TKN-SEL-CLASSNAME ZBAT-MAP-DEF-CLASS Definition ZBAT-DDL-DEF-CLASS. 02 ZINITIATION End ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-SEL-CLASSNAME ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING.!{} type ZSPI-DDL-BOOLEAN.
PAGE 143
Commands and Responses ADD EXECUTOR Command ADD EXECUTOR Command The ADD EXECUTOR command adds an executor to a scheduler. Command ZBAT-CMD-ADD Object Type ZBAT-OBJ-EXECUTOR Tokens in Command Buffer ZBAT-TKN-SEL-EXECUTORNAME ZBAT-MAP-DEF-EXECUTOR Definition ZBAT-DDL-DEF-EXECUTOR.
PAGE 144
Commands and Responses ADD SCHEDULER Command ADD SCHEDULER Command The ADD SCHEDULER command purges scheduler files (except BATCHCTL and log files) from the scheduler’s database, and creates and initializes a new database. For information on when to use the command, see Starting a Scheduler on page 2-2. Command ZBAT-CMD-ADD Object Type ZBAT-OBJ-SCHEDULER Tokens in Command Buffer ZBAT-MAP-DEF-SCHEDULER Definition ZBAT-DDL-DEF-SCHEDULER.
PAGE 145
Commands and Responses ADD SCHEDULER Command ZBAT-TKN-OUT-FILE is the name of an output file and specifies the scheduler’s DEFAULT-OUT attribute. The default is $S.#BATCH. Tokens in Response Buffer For information on the tokens present in the response buffer, see Section 4, Common Definitions. Operational Note The ADD SCHEDULER command is a sensitive command available to NetBatch supervisors only.
PAGE 146
ALTER ATTACHMENT-SET Command Commands and Responses ALTER ATTACHMENT-SET Command The ALTER ATTACHMENT-SET command changes attachment-set attributes.
PAGE 147
Commands and Responses ALTER ATTACHMENT-SET Command attachment-set-name specifies the name of an attachment set owned by user-ID or, when specified with either or both the asterisk (*) and question mark (?) wildcard characters, a range of names of attachment sets owned by userID. attachment-set-number specifies the number of an attachment set owned by user-ID. * specifies all attachment sets owned by user-ID.
PAGE 148
ALTER CLASS Command Commands and Responses ALTER CLASS Command The ALTER CLASS command changes class attributes. Command ZBAT-CMD-ALTER Object Type ZBAT-OBJ-CLASS Tokens in Command Buffer ZBAT-TKN-SEL-CLASSNAME ZBAT-MAP-DEF-CLASS Definition ZBAT-DDL-DEF-CLASS. 02 ZINITIATION End ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-SEL-CLASSNAME ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING.!{} type ZSPI-DDL-BOOLEAN.
PAGE 149
Commands and Responses ALTER EXECUTOR Command ALTER EXECUTOR Command The ALTER EXECUTOR command changes executor attributes. Command ZBAT-CMD-ALTER Object Type ZBAT-OBJ-EXECUTOR Tokens in Command Buffer ZBAT-TKN-SEL-EXECUTORNAME ZBAT-MAP-DEF-EXECUTOR Definition ZBAT-DDL-DEF-EXECUTOR.
PAGE 150
ALTER JOB Command Commands and Responses ALTER JOB Command The ALTER JOB command changes job attributes.
PAGE 151
ALTER JOB Command Commands and Responses 02 ZPOSIX 02 ZSAVEABEND 02 ZRUND 02 ZJOBID-ZERO 02 ZMEM 02 ZPFS 02 ZNAM 02 ZINFO-TIME-SUBMIT 02 ZINFO-LAST-MOD 02 ZINFO-LAST-MODUSER 02 ZTIME-LIMIT End ZBAT-MAP-DEF-WAITON Definition ZBAT-DDL-DEF-WAITON.
PAGE 152
Commands and Responses ALTER JOB Command ZBAT-TKN-SEL-JOBNAME specifies a job name or, when specified with either or both the asterisk (*) and question mark (?) wild-card characters, a range of job names. ZBAT−TKN−ATT−SET−ID specifies a value for the job’s ATTACHMENT-SET attribute in the form: [ ( user-ID ) ] attachment-set-ID user-ID specifies the user ID of the attachment-set owner. (user-ID must be in group-name.user-name or group-ID,user-ID form.) The default is the user ID of the current user.
PAGE 153
ALTER JOB Command Commands and Responses Operational Notes • The ALTER JOB command is a sensitive command. It is available to all users, but these conditions apply: ° You can alter all attributes of a job if the job has a disk input file to which you have write access. You can also alter all attributes of a job if the job’s input file is a device or a process or does not exist, but you can do this only if you are the job’s owner.
PAGE 154
Commands and Responses ALTER SCHEDULER Command ALTER SCHEDULER Command The ALTER SCHEDULER command changes scheduler attributes. Command ZBAT-CMD-ALTER Object Type ZBAT-OBJ-SCHEDULER Tokens in Command Buffer ZBAT-MAP-DEF-SCHEDULER Definition ZBAT-DDL-DEF-SCHEDULER.
PAGE 155
Commands and Responses ALTER SCHEDULER Command ZBAT-TKN-OUT-FILE is the name of an output file and specifies the scheduler’s DEFAULT-OUT attribute. Tokens in Response Buffer For information on the tokens present in the response buffer, see Section 4, Common Definitions. Operational Note The ALTER SCHEDULER command is a sensitive command available to NetBatch supervisors only.
PAGE 156
DELETE ATTACHMENT-SET Command Commands and Responses DELETE ATTACHMENT-SET Command The DELETE ATTACHMENT-SET command deletes attachment sets from a scheduler. The command also deletes specified ASSIGNs, DEFINEs (except =_DEFAULTS), and PARAMs from attachment sets.
PAGE 157
Commands and Responses DELETE ATTACHMENT-SET Command card characters, a range of names of attachment sets owned by userID. attachment-set-number specifies the number of an attachment set owned by user-ID. * specifies all attachment sets owned by user-ID. Tokens in Response Buffer For information on the tokens present in the response buffer, see Section 4, Common Definitions. Operational Note The DELETE ATTACHMENT-SET command is a sensitive command.
PAGE 158
Commands and Responses DELETE CLASS Command DELETE CLASS Command The DELETE CLASS command deletes classes from a scheduler. Command ZBAT-CMD-DELETE Object Type ZBAT-OBJ-CLASS Tokens in Command Buffer ZBAT-TKN-SEL-CLASSNAME ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-SEL-CLASSNAME ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING.!{} token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-STRING.
PAGE 159
Commands and Responses DELETE EXECUTOR Command DELETE EXECUTOR Command The DELETE EXECUTOR command deletes executors from a scheduler. Command ZBAT-CMD-DELETE Object Type ZBAT-OBJ-EXECUTOR Tokens in Command Buffer ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING.!{} token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-STRING.
PAGE 160
DELETE JOB Command Commands and Responses DELETE JOB Command The DELETE JOB command deletes from a scheduler a job that is not executing, over limit, or suspended.
PAGE 161
Commands and Responses DELETE JOB Command Operational Note The DELETE JOB command is a sensitive command. It is available to all users, but these conditions apply: • • You can delete jobs belonging to any user if you are a NetBatch supervisor. You can delete any job whose input file is a disk file to which you have write access whether or not you are a NetBatch supervisor. If the input file does not exist or is a device or process, only the owner and NetBatch supervisors can delete the job.
PAGE 162
Commands and Responses GETVERSION Command GETVERSION Command The GETVERSION command returns the NetBatch server version in token ZSPI− TKN−SERVER−VERSION in the SPI header and the server ID in token ZSPI−TKN− SERVER−BANNER. Command ZSPI-CMD-GETVERSION Object Type ZSPI-VAL-NULL-OBJECT-TYPE Tokens in Command Buffer ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZSPI−TKN−SERVER−BANNER ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING.
PAGE 163
INFO ATTACHMENT-SET Command Commands and Responses INFO ATTACHMENT-SET Command The INFO ATTACHMENT-SET command lists the attributes of attachment sets.
PAGE 164
Commands and Responses INFO ATTACHMENT-SET Command attachment-set-name specifies the name of an attachment set owned by user-ID or, when specified with either or both the asterisk (*) and question mark (?) wildcard characters, a range of names of attachment sets owned by userID. attachment-set-number specifies the number of an attachment set owned by user-ID. * specifies all attachment sets owned by user-ID.
PAGE 165
INFO CLASS Command Commands and Responses INFO CLASS Command The INFO CLASS command lists the attributes of classes. Command ZBAT-CMD-INFO Object Type ZBAT-OBJ-CLASS Tokens in Command Buffer ZBAT-TKN-SEL-CLASSNAME ZSPI-TKN-COMMENT ZSPI-TKN-CONTEXT token-type ZSPI-TYP-STRING.!{} token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-BYTESTRING. Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-SEL-CLASSNAME token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-STRING.
PAGE 166
INFO EXECUTOR Command Commands and Responses INFO EXECUTOR Command The INFO EXECUTOR command lists the attributes of executors. Command ZBAT-CMD-INFO Object Type ZBAT-OBJ-EXECUTOR Tokens in Command Buffer ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-COMMENT ZSPI-TKN-CONTEXT BYTESTRING. Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-SEL-EXECUTORNAME token-type ZSPI-TYP-STRING.!{} token-type ZSPI-TYP-STRING. token-type ZSPI-TYP- token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-STRING.
PAGE 167
INFO JOB Command Commands and Responses INFO JOB Command The INFO JOB command lists the attributes of a job.
PAGE 168
INFO JOB Command Commands and Responses 02 ZDATE. 03 ZYEAR 03 ZMONTH 03 ZDAY 02 ZTIME. 03 ZHOUR 03 ZMINUTE 03 ZSECOND 03 ZMILLISECOND 03 ZMICROSECOND 02 ZPOSIX 02 ZSAVEABEND 02 ZRUND 02 ZJOBID-ZERO 02 ZMEM 02 ZPFS 02 ZNAME 02 ZINFO-TIME-SUBMIT 02 ZINFO-LAST-MOD 02 ZINFO-LAST-MODUSER 02 ZTIME-LIMIT End ZBAT-MAP-DEF-WAITON Definition ZBAT-DDL-DEF-WAITON.
PAGE 169
Commands and Responses INFO JOB Command ZBAT-TKN-SEL-JOBNAME specifies a job name or, when specified with either or both the asterisk (*) and question mark (?) wild-card characters, a range of job names. Tokens in Response Buffer For information on the tokens present in the response buffer, see Section 4, Common Definitions. Information on the tokens specific to the INFO JOB command is: ZBAT-TKN-EXECUTOR-PROGRAM specifies the value of the job’s EXECUTOR-PROGRAM attribute.
PAGE 170
INFO SCHEDULER Command Commands and Responses INFO SCHEDULER Command The INFO SCHEDULER command lists scheduler attributes. Command ZBAT-CMD-INFO Object Type ZBAT-OBJ-SCHEDULER Tokens in Command Buffer ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZSPI-TKN-DATALIST token-type ZSPI-TYP-LIST. ZBAT-MAP-DEF-SCHEDULER Definition ZBAT-DDL-DEF-SCHEDULER.
PAGE 171
Commands and Responses INFO SCHEDULER Command ZBAT-TKN-EXECUTOR-PROGRAM specifies the value of the scheduler’s DEFAULT-EXECUTOR-PROGRAM attribute. ZBAT-TKN-OUT-FILE specifies the value of the scheduler’s DEFAULT-OUT attribute. Operational Note The INFO SCHEDULER command is a nonsensitive command available to all users.
PAGE 172
RELEASE JOB Command Commands and Responses RELEASE JOB Command The RELEASE JOB command enables a master job to release one or more of its dependents. Command ZBAT-CMD-RELEASE Object Type ZBAT-OBJ-JOB Tokens in Command Buffer ZBAT-MAP-PAR-RELEASE-JOB Definition ZBAT-DDL-PAR-RELEASE-JOB.
PAGE 173
RELEASE JOB Command Commands and Responses ZSPI-TKN-RESPONSE-TYPE is the standard SPI response-type token that lets the requester specify whether the server (that is, the scheduler) is to return all responses. The values are: ZSPI-VAL-ERRAND-WARN Causes the scheduler to return a single response record indicating whether the command was successful. ZSPI-TKNDATALIST tokens returned in the response record are ZSPI-TKNERRLIST, ZSPI-TKN-ENDLIST, and ZSPI-TKN-RETCODE.
PAGE 174
RUNNEXT JOB Command Commands and Responses RUNNEXT JOB Command The RUNNEXT JOB command makes the scheduler run a job immediately when an executor associated with the job’s class is available. The command overrides the job’s dependencies, timing attributes, and selection priority.
PAGE 175
Commands and Responses RUNNEXT JOB Command Operational Note The RUNNEXT JOB command is a sensitive command available to NetBatch supervisors only.
PAGE 176
RUNNOW JOB Command Commands and Responses RUNNOW JOB Command The RUNNOW JOB command makes the scheduler run a job immediately. The command overrides job dependencies, timing attributes, and selection priority and causes the creation of a temporary executor.
PAGE 177
Commands and Responses RUNNOW JOB Command Operational Note The RUNNOW JOB command is a sensitive command available to NetBatch supervisors only.
PAGE 178
SHUTDOWN SCHEDULER Command Commands and Responses SHUTDOWN SCHEDULER Command The SHUTDOWN SCHEDULER command shuts down a scheduler. The command allows executing and over-limit jobs to finish before shutdown, but it immediately stops suspended jobs and their processes. Command ZBAT-CMD-SHUTDOWN Object Type ZBAT-OBJ-SCHEDULER Tokens in Command Buffer ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING.
PAGE 179
START EXECUTOR Command Commands and Responses START EXECUTOR Command The START EXECUTOR command starts executors whose state is OFF or STOP, thus making them available for use by jobs. Command ZBAT-CMD-START Object Type ZBAT-OBJ-EXECUTOR Tokens in Command Buffer ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-COMMENT ZSPI-TKN-CONTEXT Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST ZSPI-TKN-CONTEXT token-type ZSPI-TYP-STRING.
PAGE 180
START SCHEDULER Command Commands and Responses START SCHEDULER Command The START SCHEDULER command makes available for use a scheduler you are cold starting or warm starting. Command ZBAT-CMD-START Object Type ZBAT-OBJ-SCHEDULER Tokens in Command Buffer ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-LIST. token-type ZSPI-TYP-SSCTL.
PAGE 181
STATUS ATTACHMENT-SET Command Commands and Responses STATUS ATTACHMENT-SET Command The STATUS ATTACHMENT-SET command lists attachment sets and the names and owners of jobs using those sets.
PAGE 182
Commands and Responses STATUS ATTACHMENT-SET Command attachment-set-number specifies the number of an attachment set owned by user-ID. * specifies all attachment sets owned by user-ID. Tokens in Response Buffer For information on the tokens present in the response buffer, see Section 4, Common Definitions. Operational Note The STATUS ATTACHMENT-SET command is a nonsensitive command available to all users.
PAGE 183
STATUS EXECUTOR Command Commands and Responses STATUS EXECUTOR Command The STATUS EXECUTOR command returns executors’ names, processors, and states. If an executor is in use by a job, the command also returns the job’s number and the name of its class. Command ZBAT-CMD-STATUS Object Type ZBAT-OBJ-EXECUTOR Tokens in Command Buffer ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-COMMENT ZSPI-TKN-CONTEXT token-type ZSPI-TYP-STRING.!{} token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-BYTESTRING.
PAGE 184
STATUS JOB Command Commands and Responses STATUS JOB Command The STATUS JOB command returns a job’s number, name, owner, state, class, selection priority or spooler log file number, and an indicator specifying whether the job was submitted from a node local to or remote from the scheduler.
PAGE 185
STATUS JOB Command Commands and Responses 02 ZTIME-USED 02 ZREMID 02 ZEXECUTOR 02 ZEXECPHANDLE 02 ZTIME−ELAPSEDMAX 02 ZTIME−CPUMAX 02 ZTIME−ELAPSEDTOTAL 02 ZTIME−CPUTOTAL 02 ZTIME−SUBMIT 02 ZLAST−CC 02 ZTIMES−RUN 02 ZTIME−LIMIT End ZBAT−TKN−PHANDLE ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST ZSPI-TKN-CONTEXT type ZSPI-DDL-INT4. type ZSPI-DDL-BOOLEAN. type ZBAT-DDL-NETBATCH-NAME. type ZSPI-DDL-PHANDLE. type ZSPI−DDL−INT4. type ZSPI−DDL−INT4. type ZSPI−DDL−INT4.
PAGE 186
STATUS SCHEDULER Command Commands and Responses STATUS SCHEDULER Command The STATUS SCHEDULER command displays information about a scheduler. Command ZBAT-CMD-STATUS Object Type ZBAT-OBJ-SCHEDULER Tokens in Command Buffer ZSPI-TKN-COMMENT token-type ZSPI-TYP-STRING. Tokens in Response Buffer ZSPI-TKN-DATALIST token-type ZSPI-TYP-LIST. ZBAT-MAP-STATUS-SCHEDULER Definition ZBAT-DDL-STATUS-SCHEDULER 02 ZSTATE type 02 ZEXECUTOR.
PAGE 187
Commands and Responses STATUS SCHEDULER Command Tokens in Response Buffer For information on the tokens present in the response buffer, see Section 4, Common Definitions. Operational Note The STATUS SCHEDULER command is a nonsensitive command available to all users.
PAGE 188
STOP EXECUTOR Command Commands and Responses STOP EXECUTOR Command The STOP EXECUTOR command stops executors whose state is ACTIVE or ON, thus making them unavailable for use by jobs. Command ZBAT-CMD-STOP Object Type ZBAT-OBJ-EXECUTOR Tokens in Command Buffer ZBAT-TKN-SEL-EXECUTORNAME !{} ZSPI-TKN-COMMENT ZSPI-TKN-CONTEXT BYTESTRING. Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-SEL-EXECUTORNAME !{} ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST ZSPI-TKN-CONTEXT BYTESTRING.
PAGE 189
STOP JOB Command Commands and Responses STOP JOB Command The STOP JOB command stops executing or suspended processes associated with a job.
PAGE 190
Commands and Responses STOP JOB Command Operational Notes • The STOP JOB command is a sensitive command. It is available to all users, but these conditions apply: ° ° • You can stop jobs belonging to any user if you are a NetBatch supervisor. You can stop any job whose input file is a disk file to which you have write access whether or not you are a NetBatch supervisor. If the input file does not exist or is a device or process, only the owner and NetBatch supervisors can stop the job.
PAGE 191
SUBMIT JOB Command Commands and Responses SUBMIT JOB Command The SUBMIT JOB command submits a job to a scheduler. Command ZBAT-CMD-SUBMIT Object Type ZBAT-OBJ-JOB Tokens in Command Buffer ZBAT-TKN-SEL-JOBNAME ZBAT-MAP-DEF-JOB Definition ZBAT-DDL-DEF-JOB.
PAGE 192
SUBMIT JOB Command Commands and Responses 02 ZPOSIX 02 ZSAVEABEND 02 ZRUND 02 ZJOBID-ZERO 02 ZMEM 02 ZPFS 02 ZNAME 02 ZINFO-TIME-SUBMIT 02 ZINFO-LAST-MOD 02 ZINFO-LAST-MODUSER 02 ZTIME-LIMIT End ZBAT-MAP-DEF-WAITON Definition ZBAT-DDL-DEF-WAITON.
PAGE 193
Commands and Responses SUBMIT JOB Command Tokens in Command Buffer For information on the tokens present in the command buffer, see Section 4, Common Definitions. Information on the tokens specific to the SUBMIT JOB command is: ZBAT-TKN-SEL-JOBNAME specifies a job name. The name can contain 1 through 24 letters and numbers. It also can contain hyphens but must begin with a letter and end with a letter or number. The name cannot contain spaces.
PAGE 194
SUBMIT JOB Command Commands and Responses default volume and subvolume. If the node name is not specified, the scheduler uses the node of the requester. Tokens in Response Buffer For information on the tokens present in the response buffer, see Section 4, Common Definitions. Operational Notes • • • • • The SUBMIT JOB command is a sensitive command available to all users. The owner of a job is the owner of the requester process that submits the job.
PAGE 195
SUSPEND JOB Command Commands and Responses SUSPEND JOB Command The SUSPEND JOB command suspends executing processes associated with a job.
PAGE 196
Commands and Responses ° ° • SUSPEND JOB Command You can suspend jobs belonging to any user if you are a NetBatch supervisor. You can suspend any job whose input file is a disk file to which you have write access whether or not you are a NetBatch supervisor. If the input file does not exist or is a device or process, only the owner and NetBatch supervisors can suspend the job.
PAGE 197
SWITCHCPU SCHEDULER Command Commands and Responses SWITCHCPU SCHEDULER Command The SWITCHCPU SCHEDULER command makes a scheduler’s primary process run in the processor of its backup process, and the backup process run in the processor of its primary process. Command ZBAT-CMD-SWITCHCPU Object Type ZBAT-OBJ-SCHEDULER Tokens in Command Buffer ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING.
PAGE 198
SWITCHLOG SCHEDULER Command Commands and Responses SWITCHLOG SCHEDULER Command The SWITCHLOG SCHEDULER command closes the current scheduler log file and opens another. Command ZBAT-CMD-SWITCHLOG Object Type ZBAT-OBJ-SCHEDULER Tokens in Command Buffer ZBAT-TKN-LOG-FILE ZSPI-TKN-COMMENT Tokens in Response Buffer ZSPI-TKN-DATALIST ZBAT-TKN-LOG-FILE ZSPI-TKN-ERRLIST … ZSPI-TKN-ENDLIST ZSPI-TKN-RETCODE ZSPI-TKN-ENDLIST token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-LIST.
PAGE 199
6 Event Messages This section describes the EMS event messages that the NetBatch subsystem can issue and the specific programming considerations for dealing with these event messages in an application. For general information about EMS, see the EMS Manual. In this section, event-message tokens and their values appear in DDL format. For an explanation of DDL, see the Data Definition Language (DDL) Reference Manual.
PAGE 200
Critical Events Event Messages Table 6-1. NetBatch Event Messages (page 1 of 2) Message Number Symbolic Name Cause Emphasis 100 ZBAT-EVTSCHEDULERSTART A START SCHEDULER command started the scheduler. Noncritical 101 ZBAT-EVTSCHEDULER-STOP An ABORT SCHEDULER or SHUTDOWN SCHEDULER command shut down the scheduler. Noncritical 102 ZBAT-EVT-JOBSTART The scheduler started the initial process (the executor program) of the job.
PAGE 201
Enabling and Disabling NetBatch Event-Message Generation Event Messages Table 6-1. NetBatch Event Messages (page 2 of 2) Message Number Symbolic Name Cause Emphasis 500 ZBAT-EVTSCHEDULERABENDED The scheduler called the ABEND or PROCESS_STOP_ (with ABEND option) system procedure because of a system resource or scheduler problem. Critical 501 ZBAT-EVT-LOGONFAILURE The scheduler could not log on to the log file owner's user ID.
PAGE 202
Step 1: Decide on Scheduler Event Messages Event Messages After writing and compiling the filter, load its compiled object file into a distributor such as the consumer distributor by using the EMS program EMSDIST. The filter then tests the value of tokens in event messages and filters the specified messages. You can write a filter to select scheduler event messages based on any token in the message.
PAGE 203
Step 4: Compile Filter Source File Event Messages Step 4: Compile Filter Source File Compile the filter source file by using the EMS filter compiler: > EMF /IN FILTSRC/ FILTOBJ EMS Filter Compiler - T9634D20 - (01JUN93) - (19JUN90) (C)1987 Tandem (C)2004 Hewlett Packard Development Company, L.P. Source file: [1] $NB.TRASH.
PAGE 204
Contents of the Format Template Supplied With NetBatch Software Event Messages Table 6-2.
PAGE 205
Contents of the Format Template Supplied With NetBatch Software Event Messages Table 6-2.
PAGE 206
Modifying the Format Template Event Messages Table 6-2. Contents of the Format Template Supplied With NetBatch Software (page 3 of 3) Message Number Symbolic Name Sample message: 94-07-28 14:50:20 \MELBDEV.$ZBAT TANDEM.BAT.D30 000201 \MELBDEV.$ZBAT:201 EXECUTOR EXEC1 is now up 202 ZBAT-EVT-JOB-NORMAL-STOP Source statements: MSG: ZEMS-TKN-EVENTNUMBER, ZBAT-EVT-JOBNORMAL-STOP "<1><2>:<3> JOB <4>(<5>) has stopped with <10>" "<*cr>Job started at <8>, CPU usage <9> microsecs, program <6>, userid <7>& .
PAGE 207
Event-Message Descriptions Event Messages Event-Message Descriptions This subsection describes event messages generated by the NetBatch subsystem. The messages appear in ascending order by event number. Each description contains: • • A header containing the event-message number and text. A box containing a list of the tokens that can appear in the event message.
PAGE 208
Event-Message Descriptions Event Messages Event-Message Text \node.$process-name specifies the node and process name of the scheduler. Cause. A START SCHEDULER command started the scheduler. Effect. The scheduler is now running as a process-pair server. Recovery. Informational message only; no corrective action required.
PAGE 209
Event-Message Descriptions Event Messages Recovery. Informational message only; no corrective action required. 102 ZBAT-EVT-JOB-START Unconditional Tokens ZSPI-TKN-SSID ZEMS-TKN-EVENTNUMBER ZEMS-TKN-EMPHASIS ZEMS-TKN-SUBJECT-MARK ZBAT-TKN-JOB-NUMBER ZBAT-TKN-JOB-NAME-ID ZBAT-TKN-USERID ZBAT-TKN-EXECUTOR-PROGRAM token-type token-type token-type token-type token-type token-type token-type token-type ZSPI-TYP-SSID. ZSPI-TYP-ENUM. ZSPI-TYP-BOOLEAN. ZSPI-TYP-MARK. ZSPI-TYP-INT. ZSPI-TYP-STRING.
PAGE 210
Event-Message Descriptions Event Messages 200 ZBAT-EVT-EXECUTOR-DOWN Unconditional Tokens ZSPI-TKN-SSID ZEMS-TKN-EVENTNUMBER ZEMS-TKN-EMPHASIS ZEMS-TKN-SUBJECT-MARK ZBAT-TKN-EXECUTOR-ID token-type token-type token-type token-type token-type ZSPI-TYP-SSID. ZSPI-TYP-ENUM. ZSPI-TYP-BOOLEAN. ZSPI-TYP-MARK. ZSPI-TYP-STRING. Event-Message Text EXECUTOR executor-name is down Unconditional Tokens For information on the unconditional tokens present in the event message, see Section 4, Common Definitions.
PAGE 211
Event-Message Descriptions Event Messages 201 ZBAT-EVT-EXECUTOR-UP Unconditional Tokens ZSPI-TKN-SSID ZEMS-TKN-EVENTNUMBER ZEMS-TKN-EMPHASIS ZEMS-TKN-SUBJECT-MARK ZBAT-TKN-EXECUTOR-ID token-type token-type token-type token-type token-type ZSPI-TYP-SSID. ZSPI-TYP-ENUM. ZSPI-TYP-BOOLEAN. ZSPI-TYP-MARK. ZSPI-TYP-STRING. Event-Message Text EXECUTOR executor-name is now up Unconditional Tokens For information on the unconditional tokens present in the event message, see Section 4, Common Definitions.
PAGE 212
Event-Message Descriptions Event Messages ZBAT-TKN-COMPLETION-CODE is the completion code set by the job’s executor-program process when it calls the ABEND, STOP, or PROCESS_STOP_ system procedure. This token has one of these values: Value Description ZBAT-ENM-CC-0 Normal, voluntary termination with no errors ZBAT-ENM-CC-1 Normal, voluntary termination with warning diagnostics For information on completion codes, see the Guardian Procedure Calls Reference Manual.
PAGE 213
Event-Message Descriptions Event Messages Cause. The job stopped without error. Effect. None Recovery. Informational message only; no corrective action required.
PAGE 214
Event-Message Descriptions Event Messages Value Description ZBAT-ENM-CC-3 Abnormal, voluntary, but premature termination with fatal errors or diagnostics. ZBAT-ENM-CC-4 The process did not start. ZBAT-ENM-CC-5 The process called ABEND or PROCESS_STOP_. ZBAT-ENM-CC-6 An external, authorized process issued an ABEND, STOP, or PROCESS_STOP_ to delete the process. The scheduler includes information about the terminator process in ZBAT-TKN-TEXT in the form: \node.$pname (group-ID,user-ID) \node.$term.
PAGE 215
Event-Message Descriptions Event Messages completion-text indicates how the job terminated. completion-text is one of: Value Description -1 TRAP detected Trap detected. Completion code -1. Job requests restart The process sent a restart request to the scheduler. Completion code 7. Normal termination Normal, voluntary termination with no errors. Completion code 0. Premature termination with fatal errors Abnormal, voluntary, but premature termination with fatal errors or diagnostics.
PAGE 216
Event-Message Descriptions Event Messages group-ID user-ID specifies the user ID of the job owner. Cause.
PAGE 217
Event-Message Descriptions Event Messages job-number specifies the number of the job. limit specifies the job’s execution time limit as specified by the LIMIT attribute. program-file-name specifies the program file name of the job’s executor-program process. group-ID user-ID specifies the user ID of the job owner. Cause. The job exceeded its execution time limit as specified by the LIMIT attribute but continued to run. Effect. The job ran longer than ZBAT-TKN-TIME-LIMIT specified. Recovery.
PAGE 218
Event-Message Descriptions Event Messages ZBAT-TKN-REASON-NUMBER indicates why the scheduler was unable to start the job’s executor-program process. This token has one of these values: Value Description ZBAT-ENMATTACHMENTSERROR The scheduler could not load DEFINEs from the job’s attachment set into the program file space of the executorprogram process.
PAGE 219
Event-Message Descriptions Event Messages Value Description ZBAT-ENM-PCERRBACCREATEUN Backup creation specified, but caller unnamed. PROCESS_CREATE_ error 22. ZBAT-ENM-PCERRBACSUBTYPE Process device subtype specified in the backup process is different than that specified in the primary process. PROCESS_CREATE_ error 21. ZBAT-ENM-PCERRBADNAME Process name error. For details, see ZBAT-TKN-PCERROR2. PROCESS_CREATE_ error 11.
PAGE 220
Event-Message Descriptions Event Messages Value Description ZBAT-ENM-PCERRNOMONITOR Unable to communicate with system-monitor process. For details, see ZBAT-TKN-PC-ERROR2. PROCESS_CREATE_ error 10. ZBAT-ENM-PCERRNOPCB No process control block available or no PIN less than 255 available. PROCESS_CREATE_ error 15. ZBAT-ENM-PCERRNOTLICENSED Unlicensed privileged program. PROCESS_CREATE_ error 17. ZBAT-ENM-PCERR-OK No error. Process created or creation initiated with the NOWAIT option.
PAGE 221
Event-Message Descriptions Event Messages : Value Description ZBAT-ENM-BADFILEDATACODEREF The file has data blocks with unresolved references in the program or library file. ZBAT-ENM-BADFILE-FILSYS The file does not have the correct file structure. ZBAT-ENM-BADFILE-INITSEGS The file header INITSEGS is not consistent with its size. ZBAT-ENM-BADFILELIBHASMAIN The library file has a main procedure. ZBAT-ENM-BADFILEMANYSPACES The file has too many code spaces.
PAGE 222
Event-Message Descriptions Event Messages Event-Message Text job-name specifies the name of the job. job-number specifies the number of the job. error-condition indicates why the scheduler could not start the job’s executor-program process. error-condition is one of: Value Description Attachments error The scheduler could not load DEFINEs from the job’s attachment set into the program file space of the executorprogram process.
PAGE 223
Event-Message Descriptions Event Messages Effect. The job failed. Recovery. Correct the cause of the error, then perform whatever actions the job owner requests. 500 ZBAT-EVT-SCHEDULER-ABENDED Unconditional Tokens ZSPI-TKN-SSID ZEMS-TKN-EVENTNUMBER ZEMS-TKN-EMPHASIS ZEMS-TKN-SUBJECT-MARK ZBAT-TKN-SCHEDULER-ID ZBAT-TKN-LOG-FILE ZBAT-TKN-DATA-BASE ZBAT-TKN-TEXT token-type token-type token-type token-type token-type token-type token-type token-type ZSPI-TYP-SSID. ZSPI-TYP-ENUM. ZSPI-TYP-BOOLEAN.
PAGE 224
Event-Message Descriptions Event Messages 2. Save the scheduler’s saveabend, database, and program files. 3. Warm start the scheduler. 4. Report the problem to your HP support representative. Provide the representative with a copy of the scheduler’s log, saveabend, database, and program files.
PAGE 225
Event-Message Descriptions Event Messages 502 ZBAT-EVT-LOGFILE-CREATE-ERROR Unconditional Tokens ZSPI-TKN-SSID ZEMS-TKN-EVENTNUMBER ZEMS-TKN-EMPHASIS ZEMS-TKN-SUBJECT-MARK ZBAT-TKN-LOG-FILE ZBAT-TKN-CREATE-ERROR ZBAT-TKN-TEXT token-type ZSPI-TYP-SSID. token-type ZSPI-TYP-ENUM. token-type ZSPI-TYP-BOOLEAN. token-type ZSPI-TYP-MARK. token-type ZSPI-TYP-STRING. token-type ZSPI-TYP-INT. token-type ZSPI-TYP-STRING.
PAGE 226
Event Messages Event-Message Descriptions NetBatch Management Programming Manual—522462-003 6- 28
PAGE 227
7 NetBatch Procedure Calls This section describes the NetBatch procedure call NB^JOB^SUBMIT and contains working C, COBOL, and TAL program examples that use the procedure. Topic Page NB^JOB^SUBMIT Procedure 7-2 Sample Programs 7-10 NB^JOB^SUBMIT syntax appears in TAL format, which is the same format used for Guardian procedure calls in the Guardian Procedure Calls Reference Manual. For notation conventions, see “Notation Conventions” in that manual.
PAGE 228
NB^JOB^SUBMIT Procedure NetBatch Procedure Calls NB^JOB^SUBMIT Procedure NB^JOB^SUBMIT is a TAL procedure defined in the NetBatch library file BATCHLIB. The procedure enables job submission and alteration from user-written programs and has functionality similar to that of the SUBMIT JOB and ALTER JOB commands.
PAGE 229
NB^JOB^SUBMIT Procedure NetBatch Procedure Calls submit-rec has the structure: DEF SUBMIT-REC. 03 FILLER 03 ACTUAL-JOB-NAME 03 FILLER 03 JOB-DETAILS. 05 SCHEDULER 05 JCLASS 05 EXECUTOR-PROGRAM 05 FILLER 05 PRINT-LINES. 07 B 05 PRINT-PAGES. 07 B 05 TAPE-DRIVES. 07 B 05 SELPRI 05 STALL 05 PRIORITY. 07 B 05 WAIT-TIME. 07 B 05 START-TIME.
PAGE 230
NetBatch Procedure Calls NB^JOB^SUBMIT Procedure SCHEDULER is the name of the job’s scheduler in [ \node. ] $process-name form. This field is mandatory. JCLASS specifies the value (a space-filled class name) of the job’s CLASS attribute. This field can be all spaces. EXECUTOR-PROGRAM specifies the value (a space-filled program-file name) of the job’s EXECUTOR-PROGRAM attribute. This field can be all spaces. PRINT-LINES specifies the value of the job’s MAXPRINTLINES attribute.
PAGE 231
NetBatch Procedure Calls NB^JOB^SUBMIT Procedure WAIT-TIME specifies the value of the job’s WAIT attribute. To specify the wait time, subtract 32768—hexadecimal 8000—from HHMM, where HH specifies 00 through 23 hours and MM specifies 00 through 59 minutes. (For example, 32768 - 1000 specifies a 10-hour wait time.) To specify no wait time, set WAIT-TIME to zero. NB^JOB^SUBMIT adds WAIT-TIME to base-date after base-date is modified by START-TIME. START-TIME specifies the job’s start time.
PAGE 232
NetBatch Procedure Calls NB^JOB^SUBMIT Procedure RESTART-FLAG is one of these uppercase values specifying the job’s RESTART attribute. This field can be all spaces. N Y RESTART OFF RESTART ON JOB-TEXT is a space-filled comment such as a job description. The scheduler ignores JOB-TEXT. This field can be all spaces. STOP-ON-ABEND is one of these uppercase values specifying the job’s STOP-ON-ABEND attribute. This field can be all spaces.
PAGE 233
NB^JOB^SUBMIT Procedure NetBatch Procedure Calls purge-test-flag input INT:value is one of these values specifying the job’s PURGE-IN-FILE attribute: -1 0 PURGE-IN-FILE ON PURGE-IN-FILE OFF Setting the value of purge-test-flag to 1 disables NB^JOB^SUBMIT’s submit and alter functions and returns the job’s rt-time . time-rec input STRUCT:ref:* specifies the job’s AT, AFTER, CALENDAR, EVERY, and IFFAILS attributes. time-rec has the structure: DEF TIME-REC. 03 T-TYPE 03 T-EVERY.
PAGE 234
NetBatch Procedure Calls NB^JOB^SUBMIT Procedure EDAYS is a number in the range 1 through 365 that specifies the execution interval in days. Zero specifies a null value. EDAYS is mandatory if HHHMM has a null value. HHHMM specifies the execution interval in hours and minutes, where HHH specifies hours in the range 000 through 168 and MM specifies minutes in the range 00 through 59. Zero specifies a null value. HHHMM is mandatory if EDAYS has a null value.
PAGE 235
NetBatch Procedure Calls NB^JOB^SUBMIT Procedure att-set input STRING:ref:43 specifies the value (an attachment-set ID) of the job’s ATTACHMENT-SET attribute. To remove the attribute from the job, specify spaces. Consideration The first call to NB^JOB^SUBMIT opens the scheduler specified by the SCHEDULER field of JOB-DETAILS in submit-rec. The data passed in open-t must not be modified after that call so that subsequent calls do not have to reopen the scheduler. open-t must be global.
PAGE 236
NetBatch Procedure Calls Sample Programs Sample Programs This subsection contains source code for sample C, COBOL, and TAL programs that illustrate use of the NB^JOB^SUBMIT procedure. Sample C Program Example 7-1 on page 7-12 contains the source code for a sample C program that demonstrates the use of NB^JOB^SUBMIT. The program uses NB^JOB^SUBMIT to submit a job to a scheduler, displays some of the job’s details, and handles error conditions.
PAGE 237
NetBatch Procedure Calls Sample C Program Step 4: Change Job Name Change job name MASTER-A to your own choice of name if MASTER-A conflicts with an existing production job in $ZBAT. Otherwise, delete job MASTER-A from $ZBAT. *CHANGE /"MASTER-A "/"NBJS-C-JOB "/ ALL 2014 strncpy (submit_rec.actual_job_name, "NBJS-CJOB ",24 ); Step 5: Compile the Source File End the EDIT session and compile the source file: *EXIT > C /IN TEMP.NBCSRC/ TEMP.
PAGE 238
Sample C Program NetBatch Procedure Calls Example 7-1. Sample NB^JOB^SUBMIT C Program #pragma INSPECT,SYMBOLS #pragma NOMAP #pragma NOLMAP #pragma RUNNABLE #pragma NOXMEM /* NOXMEM is mandatory because NB^JOB^SUBMIT cannot access extended memory */ #pragma HEAP 20 pages #pragma SEARCH "$SYSTEM.SYSTEM.
PAGE 239
Sample C Program NetBatch Procedure Calls { short b; } print_pages; struct { short } tape_drives; char char struct { short } priority; struct { short } wait_time; struct { short } start_time; char char char char char char char char char char char char char } job_details; } submit_rec; /* Base date */ struct BASE_DATE_DEF { short } base_date; /* Masters */ struct MASTERS_DEF { char } masters; /* Purge-test flag */ short /* Time rec */ struct TIME_REC_DEF (continued) b; selpri; stall; b; b; b; start_up
PAGE 240
Sample C Program NetBatch Procedure Calls { short union { struct { short short char } t_every; char } u_t_every; } time_rec; /* Run time */ struct RT_TIME_DEF { short } rt_time; /* Alter flag */ short /* Open table */ struct OPEN_TABLE_DEF { struct { short short char } table_entry[8]; short } open_table; t_type; edays; hhmm; filler_0[32]; calendar[36]; run_time[3]; alter_flag; chan; vers; sched[6]; xsum; /* Job number */ short nb_job_num; /* Att set */ char att_set[43]; /* END STRUCTURE DEFINITIO
PAGE 241
Sample C Program NetBatch Procedure Calls int *, int, int *, int *, char * ); /* /* /* /* /* RT TIME ALTER FLAG OPEN TABLE NB JOB NUM ATT SET */ */ */ */ */ #pragma page /* *-------------------------------------------------------------------* nb_init * Use: * Data setup * Effects: * Set up the job attributes required to submit a job *-------------------------------------------------------------------*/ void nb_init(void) { /* Initialize Submit rec */ strncpy (submit_rec.
PAGE 242
Sample C Program NetBatch Procedure Calls setmem ((char *) &masters.master_jobs, 192, ' '); purge_test_flag = 0; time_rec.t_type = 0; alter_flag = 0; memset (&open_table.table_entry, 0, 80); open_table.
PAGE 243
NetBatch Procedure Calls Sample C Program /* Print job information */ if (nb_job_num != 0) { printf(" Job submitted to $ZBAT using NB^JOB^SUBMIT\n\n"); printf(" Job number : %d\n", nb_job_num); printf(" Job name : %s\n", submit_rec.
PAGE 244
Sample COBOL Program NetBatch Procedure Calls Sample COBOL Program Example 7-2 on page 7-20 contains the source code for a sample COBOL program that demonstrates the use of NB^JOB^SUBMIT. The program uses NB^JOB^SUBMIT to submit a job to a scheduler, displays some of the job’s details, and handles error conditions. The source code for the program is available in the file NBSPIEX in the NetBatch installation subvolume.
PAGE 245
NetBatch Procedure Calls Sample COBOL Program Step 5: Compile Source File End the EDIT session and compile the source file: *EXIT > COBOL85 /IN TEMP.NBCOBSRC/ TEMP.NBCOBOBJ; SUPPRESS Step 6: Test the Program Test the program by running the compiled object: > RUN TEMP.NBCOBOBJ Error 00513 encountered.
PAGE 246
Sample COBOL Program NetBatch Procedure Calls Example 7-2. Sample NB^JOB^SUBMIT COBOL Program ?ENV COMMON ?SEARCH $SYSTEM.SYSTEM.COBOLLIB ?SEARCH $SYSTEM.SYSTEM.BATCHLIB ?CONSULT $SYSTEM.SYSTEM.COBOLEX0 ?SYMBOLS, INSPECT, SAVE STARTUP IDENTIFICATION DIVISION. PROGRAM-ID. DATE-WRITTEN. NBCOBSRC. November 1993.
PAGE 247
Sample COBOL Program NetBatch Procedure Calls 05 PRIORITY. 07 B 05 WAIT-TIME. 07 B 05 START-TIME. 07 B 05 START-UP 05 IN-FILE 05 OUT-FILE 05 DEFAULTS 05 FILLER 05 HOLD-FLAG 05 RESTART-FLAG 05 JOB-TEXT 05 FILLER 05 STOP-ON-ABEND 05 HIGHPIN 05 FILLER 05 HOLD-AFTER-FLAG NATIVE-2. NATIVE-2. NATIVE-2. PIC X(40). PIC X(36). PIC X(36). PIC X(26). PIC X(1). PIC X(1). PIC X(1). PIC X(32). PIC X(1). PIC X(1). PIC X(1). PIC X(6). PIC X(1). 01 BASE-DATE. 03 BD-T1 03 BD-T2 03 BD-T3 NATIVE-2. NATIVE-2. NATIVE-2.
PAGE 248
Sample COBOL Program NetBatch Procedure Calls 05 START-TIME. 07 B 05 START-UP 05 IN-FILE 05 OUT-FILE 05 DEFAULTS 05 FILLER 05 HOLD-FLAG 05 RESTART-FLAG 05 JOB-TEXT 05 FILLER 05 STOP-ON-ABEND 05 HIGHPIN 05 FILLER 05 HOLD-AFTER-FLAG NATIVE-2. PIC X(40). PIC X(36). PIC X(36). PIC X(26). PIC X(1). PIC X(1). PIC X(1). PIC X(32). PIC X(1). PIC X(1). PIC X(1). PIC X(6). PIC X(1). 01 BASE-DATE. 03 BD-T1 03 BD-T2 03 BD-T3 NATIVE-2. NATIVE-2. NATIVE-2. 01 MASTERS-ARRAY. 03 MASTERS PIC X(24) OCCURS 8 TIMES.
PAGE 249
Sample COBOL Program NetBatch Procedure Calls / PROCEDURE DIVISION. A000-MAINLINE SECTION. PERFORM B000-SETUP. PERFORM C000-SUBMIT. STOP RUN. A000-EXIT. EXIT. / B000-SETUP SECTION. *============================================================ * * * * This section: * * a) Gets the StartUp text from the system to get the * * default Volume/subvolume, * * b) Sets up the attributes for the job to be submitted.
PAGE 250
Sample COBOL Program NetBatch Procedure Calls * Set up the Submit fields MOVE "MASTER-A" MOVE W02-STARTUP-TEXT MOVE "$SYSTEM.SYSTEM.TACL" MOVE "N" MOVE "Y" TO TO TO TO TO * Set up the Base date MOVE HIGH-VALUES TO BASE-DATE. * Set up the Masters array MOVE LOW-VALUES TO MASTERS-ARRAY. * Set up the Purge/Test flag MOVE 0 TO PURGE-TEST-FLAG. * Set up Time rec MOVE 0 TO T-TYPE. ACTUAL-JOB-NAME. DEFAULTS. EXECUTOR-PROGRAM. HIGHPIN. HOLD-AFTER-FLAG, HOLD-FLAG.
PAGE 251
Sample COBOL Program NetBatch Procedure Calls *===============================================================* * * * This section: * * * * a) Submits the job to NetBatch, * b) Interprets any errors returned by the scheduler. * * *===============================================================* * Submit the job.
PAGE 252
NetBatch Procedure Calls Sample COBOL Program DISPLAY " ". DISPLAY " Job submitted to $ZBAT using NB^JOB^SUBMIT" DISPLAY " ". DISPLAY " Job number : " W02-DISPLAY-NUM. DISPLAY " Job name : " ACTUAL-JOB-NAME. DISPLAY " ". D000-EXIT. EXIT.
PAGE 253
NetBatch Procedure Calls Sample TAL Program Sample TAL Program Example 7-3 on page 7-28 contains the source code for a sample TAL program that demonstrates the use of NB^JOB^SUBMIT. The program uses NB^JOB^SUBMIT to submit a job to a scheduler, displays some of the job’s details, and handles error conditions. All instances of WAIT-TIME or START-TIME must be unsigned numerics. The source code for the program is available in the file NBSPIEX in the NetBatch installation subvolume.
PAGE 254
NetBatch Procedure Calls Sample TAL Program Step 5: Compile Source File End the EDIT session and compile the source file: *EXIT 23> TAL /IN TEMP.NBTALSRC/ TEMP.NBTALOBJ; SUPPRESS Step 6: Test the Program Test the program by running the compiled object: > RUN TEMP.NBTALOBJ Error 0513 encountered. Job submitted to $ZBAT using NB^JOB^SUBMIT Job number : 0004 Job name : NBJS-TAL-JOB Step 7: Delete the Submitted Job > BATCHCOM $ZBAT; DELETE JOB NBJS-TAL-JOB Job NBJS-TAL-JOB Jobnumber 4 deleted Example 7-3.
PAGE 255
NetBatch Procedure Calls INT fname[0:3]; END; STRUCT outfile; BEGIN INT vol[0:3]; INT subvol[0:3]; INT fname[0:3]; END; STRING param[0:529]; END; --Submit record STRUCT .
PAGE 256
Sample TAL Program NetBatch Procedure Calls STRUCT in^file; BEGIN STRING BYTE [0:35]; STRUCT out^file; BEGIN STRING BYTE [0:35]; STRUCT defaults; BEGIN STRING BYTE [0:25]; FILLER 1; STRING hold^flag; STRING restart^flag; STRUCT job^text; BEGIN STRING BYTE [0:31]; FILLER 1; STRING stop^on^abend; STRING highpin; FILLER 6; END; END; END; END; STRING hold^after^flag; END; END; STRUCT .base^date; BEGIN INT after^date[0:2]; END; STRUCT .
PAGE 257
NetBatch Procedure Calls Sample TAL Program BEGIN INT chan; INT vers; STRUCT sched; BEGIN STRING BYTE [0:5]; END; END; INT xsum; END; INT nb^job^num; STRUCT .att^set; BEGIN STRING BYTE [0:42]; END; ! END STRUCTURE DEFINITIONS USED BY NB^JOB^SUBMIT ! --String pointers to structures STRING .open^table^ptr := @open^table '<<' 1; STRING .masters^ptr := @masters '<<' 1; --Global declarations LITERAL maxfilewords = 20; LITERAL maxfilebytes = 40; INT INT INT INT INT error; out_chan; .
PAGE 258
NetBatch Procedure Calls Sample TAL Program .open^table, .nb^job^num; STRING .att^set; EXTERNAL; ?NOLIST --System procedures library ?SOURCE $SYSTEM.SYSTEM.EXTDECS0 --Location of NB^JOB^SUBMIT ?SEARCH $SYSTEM.SYSTEM.BATCHLIB ?LIST !----------------------------------------------------------! ! ! ! This proc is invoked by the INITIALIZER system routine.
PAGE 259
Sample TAL Program NetBatch Procedure Calls -- Get the Startup message and process it CALL INITIALIZER (!rucb!, !start^data!, STARTUP^PROC); -- Convert C-Series output filename to D-Series format IF (error := OLDFILENAME_TO_FILENAME_ (startup^msg.outfile.vol, work^area:maxfilebytes, work^length) ) THEN stopwitherror(err^rename, 31); -- Open the OUT file IF (error := FILE_OPEN_ (work^area:work^length, out_chan)) THEN stopwitherror(err^open, 17); -- Initialize SUBMIT^REC submit^rec.
PAGE 260
Sample TAL Program NetBatch Procedure Calls alter^flag open^table^ptr nb^job^num := 0; ':=' $LEN(OPEN^table) * [0]; := 0; -- Submit the job error := NB^JOB^SUBMIT (submit^rec, base^date, masters, purge^test^flag, time^rec, rt^time, alter^flag, open^table, nb^job^num); -- Process any errors and display them IF error THEN BEGIN CALL NUMOUT(ascii^num, error, 10, 4); out^buffer ':=' " " -> @ptr; CALL WRITE (out_chan, out^buffer, @ptr '-' @out^buffer); out^buffer ':=' " Error " & ascii^num FOR 4 & " encount
PAGE 261
A Error Numbers and Error Lists This appendix lists NetBatch subsystem error numbers (that is, the values whose symbolic names begin with ZBAT-WRN- and ZBAT-ERR-) and describes the error lists associated with the error numbers. These error numbers can occur as values of the return token ZSPI-TKN-RETCODE and as part of the value of the error token ZSPITKN-ERROR. • • • For an explanation of error lists and information about retrieving them from the buffer, see the SPI Programming Manual.
PAGE 262
Error-List Descriptions Error Numbers and Error Lists Error-List Descriptions The descriptions in this section are in ascending order by error number (that is, in ascending order by ZBAT-WRN- and ZBAT-ERR- values). 512 ZBAT-WRN-SEC-BREACH ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token.
PAGE 263
513 ZBAT-WRN-IN-NE Error Numbers and Error Lists 513 ZBAT-WRN-IN-NE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-IN-NE (513). This token is always present in the error list. Cause. ZBAT-TKN-IN-FILE specified a nonexistent job input file. Effect.
PAGE 264
515 ZBAT-WRN-CLASS-INITIATION Error Numbers and Error Lists 515 ZBAT-WRN-CLASS-INITIATION ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-CLASS-INITIATION (515). This token is always present in the error list. Cause.
PAGE 265
517 ZBAT-WRN-JOB-EXECUTING Error Numbers and Error Lists 517 ZBAT-WRN-JOB-EXECUTING ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−NETBATCH−NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−NETBATCH−NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-JOB-EXECUTING (517). This token is always present in the error list.
PAGE 266
522 ZBAT-WRN-NOT-NETWORKABLE Error Numbers and Error Lists 522 ZBAT-WRN-NOT-NETWORKABLE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-NOT-NETWORKABLE (522). This token is always present in the error list.
PAGE 267
524 ZBAT-WRN-ALTER-TAPEDRIVES Error Numbers and Error Lists 524 ZBAT-WRN-ALTER-TAPEDRIVES ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-ALTER-TAPEDRIVES (524). This token is always present in the error list. Cause.
PAGE 268
525 ZBAT-WRN-CPU-DOWN Error Numbers and Error Lists 525 ZBAT-WRN-CPU-DOWN ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-CPU-DOWN (525). This token is always present in the error list.
PAGE 269
526 ZBAT-WRN-EXECUTOR-STOPPED Error Numbers and Error Lists 526 ZBAT-WRN-EXECUTOR-STOPPED ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-EXECUTOR-STOPPED (526). This token is always present in the error list.
PAGE 270
Error Numbers and Error Lists 527 ZBAT-WRN-R-ACCESS 527 ZBAT-WRN-R-ACCESS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-R-ACCESS (527). This token is always present in the error list. Cause. ZBAT-TKN-IN-FILE specified a job input file secured against read access. Effect.
PAGE 271
Error Numbers and Error Lists 529 ZBAT-WRN-E-ACCESS 529 ZBAT-WRN-E-ACCESS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-E-ACCESS (529). This token is always present in the error list. Cause. ZBAT-TKN-EXECUTOR-PROGRAM specified a program file secured against execute access.
PAGE 272
531 ZBAT-WRN-CALENDAR-ERROR Error Numbers and Error Lists 531 ZBAT-WRN-CALENDAR-ERROR ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-CALENDAR-ERROR (531). This token is always present in the error list. ZBAT-TKN-INT contains a file-system error number. Cause.
PAGE 273
532 ZBAT-WRN-CALENDAR-EXPIRED Error Numbers and Error Lists 532 ZBAT-WRN-CALENDAR-EXPIRED ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-CALENDAR-EXPIRED (532). This token is always present in the error list. Cause.
PAGE 274
534 ZBAT-WRN-ATT-DELETED Error Numbers and Error Lists 534 ZBAT-WRN-ATT-DELETED ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-ATT-DELETED (534). This token is always present in the error list. ZBAT-TKN-STRING is the ID of the deleted attachment set.
PAGE 275
535 ZBAT-WRN-SECURITY Error Numbers and Error Lists 535 ZBAT-WRN-SECURITY ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-SECURITY (535). This token is always present in the error list.
PAGE 276
536 ZBAT-WRN-DEFAULTS-DEFINE Error Numbers and Error Lists 536 ZBAT-WRN-DEFAULTS-DEFINE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-DEFAULTS-DEFINE (536). This token is always present in the error list. Cause.
PAGE 277
540 ZBAT-WRN-RUNNOW-TAPE Error Numbers and Error Lists 540 ZBAT-WRN-RUNNOW-TAPE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-INT ZBAT−TKN−NETBATCH−NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT ZBAT−TYP−NETBATCH−NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-RUNNOW-TAPE (540). This token is always present in the error list.
PAGE 278
542 ZBAT-WRN-DISALLOW-DEFINE Error Numbers and Error Lists 542 ZBAT-WRN-DISALLOW-DEFINE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-DISALLOW-DEFINE (542). This token is always present in the error list. Cause.
PAGE 279
Error Numbers and Error Lists 547 ZBAT-WRN-SWITCHCPU-DEFERRED 547 ZBAT-WRN-SWITCHCPU-DEFERRED ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-WRN-SWITCHCPU-DEFERRED (547). This token is always present in the error list. Cause.
PAGE 280
549 ZBAT-INF-PHANDLES-OMITTED Error Numbers and Error Lists 549 ZBAT-INF-PHANDLES-OMITTED ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-INF-PHANDLES-OMITTED (549). This token is always present in the error list. Cause.
PAGE 281
2048 ZBAT-ERR-ACTIVATE-JOB Error Numbers and Error Lists 2048 ZBAT-ERR-ACTIVATE-JOB ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-NETBATCH-NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-NETBATCH-NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ACTIVATE-JOB (2048). This token is always present in the error list.
PAGE 282
2050 ZBAT-ERR-AFTER-YEAR Error Numbers and Error Lists 2050 ZBAT-ERR-AFTER-YEAR ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AFTER-YEAR (2050). This token is always present in the error list.
PAGE 283
2051 ZBAT-ERR-AFTER-MONTH Error Numbers and Error Lists 2051 ZBAT-ERR-AFTER-MONTH ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-YTP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AFTER-MONTH (2051). This token is always present in the error list.
PAGE 284
2052 ZBAT-ERR-AFTER-DAY Error Numbers and Error Lists 2052 ZBAT-ERR-AFTER-DAY ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AFTER-DAY (2052). This token is always present in the error list.
PAGE 285
2053 ZBAT-ERR-AFTER-HOUR Error Numbers and Error Lists 2053 ZBAT-ERR-AFTER-HOUR ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AFTER-HOUR (2053). This token is always present in the error list.
PAGE 286
2054 ZBAT-ERR-AFTER-MINUTE Error Numbers and Error Lists 2054 ZBAT-ERR-AFTER-MINUTE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AFTER-MINUTE (2054). This token is always present in the error list.
PAGE 287
2056 ZBAT-ERR-AT Error Numbers and Error Lists 2056 ZBAT-ERR-AT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AT (2056). This token is always present in the error list. Cause. The scheduler has the attribute AT-ALLOWED OFF.
PAGE 288
2068 ZBAT-ERR-CALENDAR-FILECODE Error Numbers and Error Lists 2068 ZBAT-ERR-CALENDAR-FILECODE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-CALENDAR-FILECODE (2068). This token is always present in the error list. Cause. ZBAT-TKN-CALENDAR specified a file not generated by BATCHCAL. Effect.
PAGE 289
2071 ZBAT-ERR-CLASS-COUNT Error Numbers and Error Lists 2071 ZBAT-ERR-CLASS-COUNT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-CLASS-COUNT (2071). This token is always present in the error list.
PAGE 290
Error Numbers and Error Lists 2073 ZBAT-ERR-CONTEXT 2073 ZBAT-ERR-CONTEXT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-CONTEXT (2073). This token is always present in the error list. Cause. A command changed the value of a context token.
PAGE 291
2074 ZBAT-ERR-CPU Error Numbers and Error Lists 2074 ZBAT-ERR-CPU ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-CPU (2074). This token is always present in the error list. ZBAT−TKN−MIN−MAX−ERROR contains three values in this error list.
PAGE 292
Error Numbers and Error Lists 2076 ZBAT-ERR-NO-CPU 2076 ZBAT-ERR-NO-CPU ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-NO-CPU (2076). This token is always present in the error list. Cause. The ADD EXECUTOR command did not specify a processor in the ZCPU field of ZBAT-MAP-DEF-EXECUTOR. Effect.
PAGE 293
2078 ZBAT-ERR-EVERY-ZERO-MINUTES Error Numbers and Error Lists 2078 ZBAT-ERR-EVERY-ZERO-MINUTES ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-EVERY-ZERO-MINUTES (2078). This token is always present in the error list. Cause.
PAGE 294
2079 ZBAT-ERR-EVERY Error Numbers and Error Lists 2079 ZBAT-ERR-EVERY ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-EVERY (2079). This token is always present in the error list.
PAGE 295
2080 ZBAT-ERR-EVERY-CAL-CRON Error Numbers and Error Lists 2080 ZBAT-ERR-EVERY-CAL-CRON ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-EVERY-CAL-CRON (2080). This token is always present in the error list. Cause.
PAGE 296
2058 ZBAT-ERR-WAITON-SELF Error Numbers and Error Lists 2058 ZBAT-ERR-WAITON-SELF ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-WAITON-SELF (2085). This token is always present in the error list. Cause.
PAGE 297
2087 ZBAT-ERR-NO-SUCH-EXECUTOR Error Numbers and Error Lists 2087 ZBAT-ERR-NO-SUCH-EXECUTOR ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-EXECUTORNAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-NO-SUCH-EXECUTOR (2087). This token is always present in the error list.
PAGE 298
2091 ZBAT-ERR-HOLD Error Numbers and Error Lists 2091 ZBAT-ERR-HOLD ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-HOLD (2091). This token is always present in the error list. Cause. The ZHOLD field of ZBAT-MAP-DEF-JOB specified an invalid value for the job’s HOLD attribute. Effect.
PAGE 299
2093 ZBAT-ERR-IN Error Numbers and Error Lists 2093 ZBAT-ERR-IN ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-IN (2093). This token is always present in the error list. ZBAT-TKN-STRING is the invalid file name specified by ZBAT-TKN-IN-FILE. Cause.
PAGE 300
2096 ZBAT-ERR-USER-UNDEFINED Error Numbers and Error Lists 2096 ZBAT-ERR-USER-UNDEFINED ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-USER-UNDEFINED (2096). This token is always present in the error list. Cause. The owner of the application issuing the command has an invalid user ID. Effect.
PAGE 301
2099 ZBAT-ERR-NO-SUCH-JOB Error Numbers and Error Lists 2099 ZBAT-ERR-NO-SUCH-JOB ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-NO-SUCH-JOB (2099). This token is always present in the error list. Cause. ZBAT-TKN-SEL-JOBNAME or ZBAT-TKN-SEL-JOB-NUMBER specified a nonexistent job. Effect.
PAGE 302
2104 ZBAT-ERR-CLASS-IN-USE Error Numbers and Error Lists 2104 ZBAT-ERR-CLASS-IN-USE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-CLASSNAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-CLASS-IN-USE (2104). This token is always present in the error list.
PAGE 303
2105 ZBAT-ERR-NO-SUCH-CLASS Error Numbers and Error Lists 2105 ZBAT-ERR-NO-SUCH-CLASS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-CLASSNAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-NO-SUCH-CLASS (2105). This token is always present in the error list.
PAGE 304
2107 ZBAT-ERR-JOBNAME-EXISTS Error Numbers and Error Lists 2107 ZBAT-ERR-JOBNAME-EXISTS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-NETBATCH-NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-NETBATCH-NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-JOBNAME-EXISTS (2107). This token is always present in the error list.
PAGE 305
2117 ZBAT-ERR-EMPTY-RESPONSE Error Numbers and Error Lists 2117 ZBAT-ERR-EMPTY-RESPONSE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-EMPTY-RESPONSE (2117). This token is always present in the error list. Cause.
PAGE 306
2118 ZBAT-ERR-MAXPRINTLINES Error Numbers and Error Lists 2118 ZBAT-ERR-MAXPRINTLINES ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MAXPRINTLINES (2118). This token is always present in the error list.
PAGE 307
2119 ZBAT-ERR-MAXPRINTPAGES Error Numbers and Error Lists 2119 ZBAT-ERR-MAXPRINTPAGES ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MAXPRINTPAGES (2119). This token is always present in the error list.
PAGE 308
2120 ZBAT-ERR-MAXRESP Error Numbers and Error Lists 2120 ZBAT-ERR-MAXRESP ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MAXRESP (2120). This token is always present in the error list.
PAGE 309
2122 ZBAT-ERR-MISSING-CLASS Error Numbers and Error Lists 2122 ZBAT-ERR-MISSING-CLASS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MISSING-CLASS (2122). This token is always present in the error list. Cause.
PAGE 310
Error Numbers and Error Lists 2124 ZBAT-ERR-MULTIPLE-MAPS 2124 ZBAT-ERR-MULTIPLE-MAPS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MULTIPLE-MAPS (2124). This token is always present in the error list. Cause.
PAGE 311
2126 ZBAT-ERR-NAME-AND-NUMBER Error Numbers and Error Lists 2126 ZBAT-ERR-NAME-AND-NUMBER ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-INT ZBAT−TKN−NETBATCH−NAME ZBAT−TKN−NETBATCH−NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT ZBAT−TYP−NETBATCH−NAME ZBAT−TYP−NETBATCH−NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token.
PAGE 312
2127 ZBAT-ERR-NAME-OR-NUMBER Error Numbers and Error Lists 2127 ZBAT-ERR-NAME-OR-NUMBER ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-NAME-OR-NUMBER (2127). This token is always present in the error list. Cause.
PAGE 313
2129 ZBAT-ERR-INVALID-COMMAND Error Numbers and Error Lists 2129 ZBAT-ERR-INVALID-COMMAND ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−NETBATCH−NAME ZBAT−TKN−NETBATCH−NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−NETBATCH−NAME ZBAT−TYP−NETBATCH−NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-INVALID-COMMAND (2129).
PAGE 314
2132 ZBAT-ERR-SECURITY Error Numbers and Error Lists 2132 ZBAT-ERR-SECURITY ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−NETBATCH−NAME ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−NETBATCH−NAME ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-SECURITY (2132). This token is always present in the error list.
PAGE 315
2136 ZBAT-ERR-OUT Error Numbers and Error Lists 2136 ZBAT-ERR-OUT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-OUT (2136). This token is always present in the error list. ZBAT-TKN-STRING is the invalid file name specified by ZBAT-TKN-OUT-FILE.
PAGE 316
2137 ZBAT-ERR-PRI Error Numbers and Error Lists 2137 ZBAT-ERR-PRI ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-PRI (2137). This token is always present in the error list. ZBAT−TKN−MIN−MAX−ERROR contains three values in this error list.
PAGE 317
2140 ZBAT-ERR-STOP-ON-ABEND Error Numbers and Error Lists 2140 ZBAT-ERR-STOP-ON-ABEND ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-STOP-ON-ABEND (2140). This token is always present in the error list. Cause.
PAGE 318
2141 ZBAT-ERR-RUNNEXT Error Numbers and Error Lists 2141 ZBAT-ERR-RUNNEXT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−INT ZBAT−TKN−SEL-JOBNAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-RUNNEXT (2141). This token is always present in the error list.
PAGE 319
2142 ZBAT-ERR-RUNNEXT-RUNNOW Error Numbers and Error Lists 2142 ZBAT-ERR-RUNNEXT-RUNNOW ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−INT ZBAT−TKN−SEL-JOBNAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-RUNNEXT-RUNNOW (2142). This token is always present in the error list.
PAGE 320
2143 ZBAT-ERR-SWITCHLOG-EDIT Error Numbers and Error Lists 2143 ZBAT-ERR-SWITCHLOG-EDIT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-SWITCHLOG-EDIT (2143). This token is always present in the error list.
PAGE 321
2144 ZBAT-ERR-SELPRI Error Numbers and Error Lists 2144 ZBAT-ERR-SELPRI ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-SELPRI (2144). This token is always present in the error list.
PAGE 322
2145 ZBAT-ERR-STARTUP-MESSAGE Error Numbers and Error Lists 2145 ZBAT-ERR-STARTUP-MESSAGE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-STARTUP-MESSAGE (2145). This token is always present in the error list.
PAGE 323
2148 ZBAT-ERR-SUSPEND-JOB Error Numbers and Error Lists 2148 ZBAT-ERR-SUSPEND-JOB ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-SUSPEND-JOB (2148). This token is always present in the error list. Cause. The SUSPEND JOB command specified a job that was not executing or over limit.
PAGE 324
2149 ZBAT-ERR-TAPEDRIVES Error Numbers and Error Lists 2149 ZBAT-ERR-TAPEDRIVES ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-TAPEDRIVES (2149). This token is always present in the error list.
PAGE 325
2151 ZBAT-ERR-UNKNOWN-OBJECT Error Numbers and Error Lists 2151 ZBAT-ERR-UNKNOWN-OBJECT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−INT ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-UNKNOWN-OBJECT (2151). This token is always present in the error list.
PAGE 326
2154 ZBAT-ERR-VOLUME-REQUIRED Error Numbers and Error Lists 2154 ZBAT-ERR-VOLUME-REQUIRED ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-VOLUME-REQUIRED (2154). This token is always present in the error list. Cause. The command did not specify the required token ZBAT-TKN-VOLUMESUBVOL. Effect.
PAGE 327
2158 ZBAT-ERR-WAITON-COUNT Error Numbers and Error Lists 2158 ZBAT-ERR-WAITON-COUNT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-WAITON-COUNT (2158). This token is always present in the error list. Cause. ZBAT-MAP-DEF-WAITON specified more than eight master jobs.
PAGE 328
Error Numbers and Error Lists 2167 ZBAT-ERR-SWITCHCPU 2167 ZBAT-ERR-SWITCHCPU ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-SWITCHCPU (2167). This token is always present in the error list. Cause. The scheduler attempted to switch processors in response to a SWITCHCPU SCHEDULER command.
PAGE 329
2168 ZBAT-ERR-LOGFILE Error Numbers and Error Lists 2168 ZBAT-ERR-LOGFILE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−INT ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-LOGFILE (2168). This token is always present in the error list.
PAGE 330
2169 ZBAT-ERR-NOT-C20-FILE Error Numbers and Error Lists 2169 ZBAT-ERR-NOT-C20-FILE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-NOT-C20-FILE (2169). This token is always present in the error list.
PAGE 331
2170 ZBAT-ERR-DST Error Numbers and Error Lists 2170 ZBAT-ERR-DST ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−INT ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-DST (2170). This token is always present in the error list. ZBAT-TKN-INT contains a CONVERTTIMESTAMP-procedure error number. Cause.
PAGE 332
2171 ZBAT-ERR-ATT-EXISTS Error Numbers and Error Lists 2171 ZBAT-ERR-ATT-EXISTS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ATT-EXISTS (2171). This token is always present in the error list.
PAGE 333
2173 ZBAT-ERR-ATT-JOB Error Numbers and Error Lists 2173 ZBAT-ERR-ATT-JOB ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ATT-JOB (2173). This token is always present in the error list.
PAGE 334
2174 ZBAT-ERR-ATT-REQUESTOR Error Numbers and Error Lists 2174 ZBAT-ERR-ATT-REQUESTOR ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−STRING ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−STRING ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ATT-REQUESTOR (2174). This token is always present in the error list.
PAGE 335
2175 ZBAT-ERR-ATT Error Numbers and Error Lists 2175 ZBAT-ERR-ATT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ATT (2175). This token is always present in the error list. ZBAT-TKN-STRING is the invalid attachment-set ID specified in the command.
PAGE 336
2177 ZBAT-ERR-ATT-OVERFLOW Error Numbers and Error Lists 2177 ZBAT-ERR-ATT-OVERFLOW ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-ASSIGN-NAME ZBAT-TKN-SEL-PARAM-NAM ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token.
PAGE 337
2178 ZBAT-ERR-ATT-UPDATE Error Numbers and Error Lists 2178 ZBAT-ERR-ATT-UPDATE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ATT-UPDATE (2178). This token is always present in the error list. Cause.
PAGE 338
2189 ZBAT-ERR-FILE-ERROR Error Numbers and Error Lists 2189 ZBAT-ERR-FILE-ERROR ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−INT ZBAT−TKN−STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT ZBAT−TYP−STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-FILE-ERROR (2189). This token is always present in the error list.
PAGE 339
2192 ZBAT-ERR-INVALID-SPI Error Numbers and Error Lists 2192 ZBAT-ERR-INVALID-SPI ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−INT ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−TYP−INT ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-INVALID-SPI (2192). This token is always present in the error list. ZBAT-TKN-INT contains an SPI error number. Cause.
PAGE 340
2193 ZBAT-ERR-NETBATCH-NAME Error Numbers and Error Lists 2193 ZBAT-ERR-NETBATCH-NAME ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−NETBATCH-NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−NETBATCH-NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-NETBATCH-NAME (2193). This token is always present in the error list.
PAGE 341
2194 ZBAT-ERR-SUSPEND Error Numbers and Error Lists 2194 ZBAT-ERR-SUSPEND ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−NETBATCH-NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−NETBATCH-NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-SUSPEND (2194). This token is always present in the error list.
PAGE 342
2195 ZBAT-ERR-ACTIVATE Error Numbers and Error Lists 2195 ZBAT-ERR-ACTIVATE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−NETBATCH-NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−NETBATCH-NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ACTIVATE (2195). This token is always present in the error list.
PAGE 343
2196 ZBAT-ERR-STOP Error Numbers and Error Lists 2196 ZBAT-ERR-STOP ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT−TKN−NETBATCH-NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT−NETBATCH-NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-STOP (2196). This token is always present in the error list.
PAGE 344
2198 ZBAT-ERR-WILDCARD Error Numbers and Error Lists 2198 ZBAT-ERR-WILDCARD ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-WILDCARD (2198). This token is always present in the error list. Cause. The RUNNEXT JOB or RUNNOW JOB command used wild-card characters to specify a range of job names.
PAGE 345
2200 ZBAT-ERR-DATE Error Numbers and Error Lists 2200 ZBAT-ERR-DATE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-DATE (2200). This token is always present in the error list. Cause. The ZDATE field of ZBAT-MAP-DEF-JOB specified values for some but not all of ZYEAR, ZMONTH, and ZDAY.
PAGE 346
2202 ZBAT-ERR-AT-FLAG Error Numbers and Error Lists 2202 ZBAT-ERR-AT-FLAG ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AT-FLAG (2202). This token is always present in the error list. Cause. The ZAT-FLAG field of ZBAT-MAP-DEF-JOB specified an invalid value for the job’s AT flag. Effect.
PAGE 347
2204 ZBAT-ERR-MISSING-ATT-ID Error Numbers and Error Lists 2204 ZBAT-ERR-MISSING-ATT-ID ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MISSING-ATT-ID (2204). This token is always present in the error list. Cause.
PAGE 348
2206 ZBAT-ERR-ATT-ASSIGN Error Numbers and Error Lists 2206 ZBAT-ERR-ATT-ASSIGN ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-ASSIGN-NAME ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ATT-ASSIGN (2206). This token is always present in the error list.
PAGE 349
2207 ZBAT-ERR-ATT-DEFINE Error Numbers and Error Lists 2207 ZBAT-ERR-ATT-DEFINE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-MAP-DEFINE-ERROR ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT-DDL-DEFINE-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ATT-DEFINE (2207). This token is always present in the error list.
PAGE 350
2208 ZBAT-ERR-ATT-PARAM Error Numbers and Error Lists 2208 ZBAT-ERR-ATT-PARAM ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-PARAM-NAME ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-ATT-PARAM (2208). This token is always present in the error list.
PAGE 351
2210 ZBAT-ERR-AFTER-SECOND Error Numbers and Error Lists 2210 ZBAT-ERR-AFTER-SECOND ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AFTER-SECOND (2210). This token is always present in the error list.
PAGE 352
2211 ZBAT-ERR-AFTER-MILLISEC Error Numbers and Error Lists 2211 ZBAT-ERR-AFTER-MILLISEC ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AFTER-MILLISEC (2211). This token is always present in the error list.
PAGE 353
2212 ZBAT-ERR-AFTER-MICROSEC Error Numbers and Error Lists 2212 ZBAT-ERR-AFTER-MICROSEC ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-AFTER-MICROSEC (2212). This token is always present in the error list.
PAGE 354
2213 ZBAT-ERR-CLASS-NAME Error Numbers and Error Lists 2213 ZBAT-ERR-CLASS-NAME ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-SEL-CLASSNAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST. ZSPI-TYP-ERROR. ZSPI-TYP-STRING. ZSPI-TYP-SSCTL. Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-CLASS-NAME (2213). This token is always present in the error list.
PAGE 355
2214 ZBAT-ERR-WAITON-ID Error Numbers and Error Lists 2214 ZBAT-ERR-WAITON-ID ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-NETBATCH-NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-NETBATCH-NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-WAITON-ID (2214). This token is always present in the error list.
PAGE 356
2215 ZBAT-ERR-EXECUTOR-NAME Error Numbers and Error Lists 2215 ZBAT-ERR-EXECUTOR-NAME ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-NETBATCH-NAME ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-NETBATCH-NAME ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-EXECUTOR-NAME (2215). This token is always present in the error list.
PAGE 357
Error Numbers and Error Lists 2217 ZBAT-ERR-VAR-BUF-FULL 2217 ZBAT-ERR-VAR-BUF-FULL ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-VAR-BUF-FULL (2217). This token is always present in the error list. Cause.
PAGE 358
Error Numbers and Error Lists 2219 ZBAT-ERR-PURGE-IN-FILE 2219 ZBAT-ERR-PURGE-IN-FILE ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-PURGE-IN-FILE (2219). This token is always present in the error list. Cause.
PAGE 359
2221 ZBAT-ERR-POSIX Error Numbers and Error Lists 2221 ZBAT-ERR-POSIX ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-POSIX (2221). This token is always present in the error list. Cause. The ZPOSIX field of ZBAT-MAP-DEF-JOB specified an invalid value. Effect. The command failed. Recovery.
PAGE 360
2223 ZBAT-ERR-RUND Error Numbers and Error Lists 2223 ZBAT-ERR-RUND ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-RUND (2223). This token is always present in the error list. Cause. The ZRUND field of ZBAT-MAP-DEF-JOB specified an invalid value for the job’s RUND attribute. Effect.
PAGE 361
2225 ZBAT-ERR-MEM Error Numbers and Error Lists 2225 ZBAT-ERR-MEM ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MEM (2225). This token is always present in the error list. ZBAT−TKN−MIN−MAX−ERROR contains three values in this error list.
PAGE 362
2226 ZBAT-ERR-TIME-LIMIT Error Numbers and Error Lists 2226 ZBAT-ERR-TIME-LIMIT ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-TIME-LIMIT (2226). This token is always present in the error list.
PAGE 363
Error Numbers and Error Lists 2228 ZBAT-ERR-TOO-MANY-SELECTORS 2228 ZBAT-ERR-TOO-MANY-SELECTORS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-TOO-MANY-SELECTORS (2228). This token is always present in the error list. Cause.
PAGE 364
2229 ZBAT-ERR-NODENAME Error Numbers and Error Lists 2229 ZBAT-ERR-NODENAME ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-STRING ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZSPI-TYP-STRING ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-NODENAME (2229). This token is always present in the error list. ZBAT-TKN-STRING is the name of the invalid remote node. Cause.
PAGE 365
2230 ZBAT-ERR-MAXPRI Error Numbers and Error Lists 2230 ZBAT-ERR-MAXPRI ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MAXPRI (2230). This token is always present in the error list.
PAGE 366
Error Numbers and Error Lists 2231 ZBAT-ERR-MAXCONCURRENTJOBS 2231 ZBAT-ERR-MAXCONCURRENTJOBS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MAXCONCURRENTJOBS (2231). This token is always present in the error list.
PAGE 367
2232 ZBAT-ERR-MAXTEMPEXECUTORS Error Numbers and Error Lists 2232 ZBAT-ERR-MAXTEMPEXECUTORS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZBAT-TKN-MIN-MAX-ERROR ZSPI-TKN-ENDLIST token-type token-type token-type token-type ZSPI-TYP-LIST ZSPI-TYP-ERROR ZBAT-TYP-INT2-TRIO ZSPI-TYP-SSCTL Tokens ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-MAXTEMPEXECUTORS (2232). This token is always present in the error list.
PAGE 368
2234 ZBAT-ERR-EMS Error Numbers and Error Lists 2234 ZBAT-ERR-EMS ZSPI-TKN-ERRLIST ZSPI-TKN-ERROR ZSPI-TKN-ENDLIST token-type ZSPI-TYP-LIST token-type ZSPI-TYP-ERROR token-type ZSPI-TYP-SSCTL Token ZSPI-TKN-ERROR is the standard SPI error token. Its value consists of the NetBatch subsystem ID and the error number ZBAT-ERR-EMS (2234). This token is always present in the error list. Cause. The ZEMS field of ZBAT-MAP-DEF-SCHEDULER specified an invalid value for the scheduler’s EMS attribute. Effect.
PAGE 369
B Token Codes and Token Maps This appendix lists token information specific to the NetBatch subsystem, including: • • Token codes specific to the NetBatch subsystem and the token type for each token code Token maps specific to the NetBatch subsystem and the DDL definition for each token map NetBatch Management Programming Manual—522462-003 B- 1
PAGE 370
Token Codes and Token Maps NetBatch Token Codes and Token Types NetBatch Token Codes and Token Types Table B-1 lists token codes specific to the NetBatch subsystem (that is, token codes whose names begin with ZBAT-TKN-). For each code, the table shows the token type. You can derive the symbolic name of the token number of a token code from the name of the token code by replacing -TKN- with -TNM-. For example, token code ZBAT-TKNOBJECT has the token number ZBAT-TNM-OBJECT. Table B-1.
PAGE 371
Token Codes and Token Maps NetBatch Token Codes and Token Types Table B-1.
PAGE 372
Token Codes and Token Maps NetBatch Token Codes and Token Types Table B-1.
PAGE 373
NetBatch Token Maps and DDL Definitions Token Codes and Token Maps NetBatch Token Maps and DDL Definitions Table B-2 lists token maps specific to the NetBatch subsystem (that is, token maps whose names begin with ZBAT-MAP-). For each token map, the table shows the DDL definition. You can derive the symbolic name of the token number of a token map from the name of the token map by replacing -MAP- with -TNM-. For example, token map ZBAT-MAPDEF-JOB has the token number ZBAT-TNM-DEF-JOB. Table B-2.
PAGE 374
NetBatch Token Maps and DDL Definitions Token Codes and Token Maps Table B-2. NetBatch Token Maps and DDL Definitions (page 2 of 8) Token Map DDL Definition ZBAT-MAP-DEFJOB Definition ZBAT-DDL-DEF-JOB.
PAGE 375
NetBatch Token Maps and DDL Definitions Token Codes and Token Maps Table B-2. NetBatch Token Maps and DDL Definitions (page 3 of 8) Token Map DDL Definition 02 ZDATE. 03 ZYEAR Type ZSPI-DDL-INT 03 ZMONTH Type ZSPI-DDL-INT 03 ZDAY Type ZSPI-DDL-INT 02 ZTIME.
PAGE 376
NetBatch Token Maps and DDL Definitions Token Codes and Token Maps Table B-2. NetBatch Token Maps and DDL Definitions (page 4 of 8) Token Map DDL Definition ZBAT-MAP-DEFSCHEDULER Definition ZBAT-DDL-DEFSCHEDULER.
PAGE 377
NetBatch Token Maps and DDL Definitions Token Codes and Token Maps Table B-2. NetBatch Token Maps and DDL Definitions (page 5 of 8) Token Map DDL Definition ZBAT-MAPDEFINE-ERROR Definition ZBAT-DDL-DEFINEERROR. 02 ZNAMELEN Type ZSPI-DDL-INT. 02 ZNAMETXT Type ZSPI-DDL-CHAR24. 02 ZERR Type ZSPI-DDL-INT. 02 ZATTRLEN Type ZSPI-DDL-INT. 02 ZATTRTXT Type ZSPI-DDL-CHAR16. 02 ZCLASSLEN Type ZSPI-DDL-INT. 02 ZCLASSTXT Type ZSPI-DDL-CHAR16. 02 ZCHECKNUM Type ZSPI-DDL-INT.
PAGE 378
NetBatch Token Maps and DDL Definitions Token Codes and Token Maps Table B-2. NetBatch Token Maps and DDL Definitions (page 6 of 8) Token Map DDL Definition ZBAT-MAPSTATUSEXECUTOR Definition ZBAT-DDL-STATUSEXECUTOR. 02 ZCPU Type ZSPI-DDL-INT. 02 ZJOBNUMBER Type ZSPI-DDL-INT. 02 ZWHICH-LIST Type ZSPI-DDL-EXECUTOR-LIST. 02 ZCLASS Type ZSPI-DDL-NETBATCH-NAME.
PAGE 379
NetBatch Token Maps and DDL Definitions Token Codes and Token Maps Table B-2. NetBatch Token Maps and DDL Definitions (page 7 of 8) Token Map DDL Definition ZBAT-MAPSTATUS-JOB Definition ZBAT-DDL-STATUSJOB. 02 ZOUT-SPOOL-NUM Type ZSPI-DDL-INT. 02 ZSELPRI Type ZSPI-DDL-INT. 02 ZOPEN-ACCESSORDETAIL. Type ZSPI-DDL-BYTE. 03 ZGROUP Type ZSPI-DDL-BYTE. 03 ZUSER Redefines ZOPEN-ACCESSORDETAIL 02 ZOPEN-ACCESSOR Type ZSPI-DDL-INT. 02 ZCLASSNAME Type ZSPI-DDL-NETBATCH-NAME.
PAGE 380
NetBatch Token Maps and DDL Definitions Token Codes and Token Maps Table B-2. NetBatch Token Maps and DDL Definitions (page 8 of 8) Token Map DDL Definition ZBAT-MAPSTATUSSCHEDULER Definition ZBAT-DDL-STATUSSCHEDULER. 02 ZSTATE Type ZBAT-DDL-SCHEDULARSTATE. 02 ZEXECUTOR. 03 ZOFF Type ZSPI-DDL-INT. 03 ZON Type ZSPI-DDL-INT. 03 ZACTIVE Type ZSPI-DDL-INT. 03 ZSTOP Type ZSPI-DDL-INT. 03 ZDOWN Type ZSPI-DDL-INT. 03 ZDELETE Type ZSPI-DDL-INT. 02 ZJOB. 03 ZREADY Type ZSPI-DDL-INT.
PAGE 381
C Sample Programs This appendix contains source code for sample C, COBOL, TACL, and TAL programs that illustrate programmatic management of the NetBatch subsystem.
PAGE 382
Sample C Program Sample Programs Sample C Program Example C-1 on page C-4 contains the source code for a sample C program. The program submits a job to a scheduler, executes a STATUS JOB command on the submitted job, and displays some job details. The source code for the program is available in the file NBSPIEX in the NetBatch installation subvolume. The prerequisite to completing the procedure is a D21 or later scheduler named $ZBAT running on the node where the program will run.
PAGE 383
Sample C Program Sample Programs Step 5: Compile Source File End the EDIT session and compile the source file: *EXIT > C /IN TEMP.CSRC/ TEMP.COBJ; SUPPRESS Step 6: Test the Program Test the program by running the compiled object: > RUN TEMP.
PAGE 384
Sample C Program Sample Programs Example C-1. Sample SPI C Program #pragma #pragma #pragma #pragma #pragma #pragma INSPECT,SYMBOLS NOMAP NOLMAP RUNNABLE XMEM HEAP 20 pages / * *#################################################################### *# # *# This C source code compiles into a sample program that # *# demonstrates the subsystem programmatic interface (SPI) to the # *# NetBatch scheduler.
PAGE 385
Sample C Program Sample Programs /* These DEFINEs are used for zbat structs to shorten names */ #define BATBUFDEF zbat_ddl_msg_buffer_def /* Use this struct for variable-length string tokens */ typedef struct bytestr_buf { int len; /* Length or count of string in bytes */ char str[MAXFILEBYTES]; /* Data */ } BYTESTR; BATBUFDEF *spi_buff; /* Global SPI buffer */ /* Declare the ssids using the typedefs from the DDL output */ zbat_val_ssid_def zbat_val_ssid; zbat_ddl_def_job_def zbat_ddl_status_job_def
PAGE 386
Sample C Program Sample Programs *------------------------------------------------------------------* stopwitherror(error, err_msg) * Use: * Error handling * Effects: * Forces the program to abend with CC and prints message passed * *-------------------------------------------------------------------*/ void stopwitherror(const short errnum, char * err_msg) { PROCESS_STOP_ (,,,2,(short)errnum,,(char *) err_msg,(short )strlen(err_msg)); } #pragma page /* *-------------------------------------------------
PAGE 387
Sample C Program Sample Programs int char status = 0; schname[12] = "$ZBAT.
PAGE 388
Sample C Program Sample Programs /* Get the RETCODE token returned in the SPI buffer */ spi_err = SSGETTKN ( (short *) (long) (char *) 1 ); spi_buff, ZSPI_TKN_RETCODE, &retcode, if (spi_err != ZSPI_ERR_OK) stopwitherror(spi_err, (char *) &essgettkn); /* Return the SPI RETCODE */ return (retcode); } #pragma page /* *-------------------------------------------------------------------* submit_job * Use: * Submits a job to the scheduler * Effects: * Sets SPI buffer to job submit details if successful * Sto
PAGE 389
Sample C Program Sample Programs ); if (spi_err != ZSPI_ERR_OK) stopwitherror(spi_err, (char *) &essinit); /* Insert the job-name token */ strcpy (work_area.str, "MASTER-A"); work_area.len = strlen(work_area.str); spi_err = SSPUTTKN ( (short *) buffer */ (long) spi_buff, /* SPI ZBAT_TKN_SEL_JOBNAME, /* Token ID */ (char *) &work_area /* Token value */ ); if (spi_err != ZSPI_ERR_OK) stopwitherror(spi_err, (char *) &essputtkn); /* Insert the executor-program token */ strcpy (work_area.
PAGE 390
Sample C Program Sample Programs if (spi_err != ZSPI_ERR_OK) stopwitherror(spi_err, (char *) &essputtkn); /* Insert the in-file token */ strcpy (work_area.str, getenv("DEFAULTS")); strcat (work_area.str, ".INFILE"); work_area.len = strlen(work_area.
PAGE 391
Sample C Program Sample Programs spi_err = SSPUT ( (short *) spi_buff, (short *) zbat_map_def_job, (char *) &JOB ); if (spi_err != ZSPI_ERR_OK) stopwitherror(spi_err, (char *) &essput); /* Do WriteRead to scheduler */ retcode = send_spi(); if (retcode != 0) stopwitherror(retcode, (char *) &eretcode); } #pragma page /* *-------------------------------------------------------------------* status_job * Use: * Perform status job on the job number passed * Effects: * Sets SPI buffer to status job details if su
PAGE 392
Sample C Program Sample Programs spi_err = SSPUTTKN ( (short *) spi_buff, buffer /* SPI */ (long) ZBAT_TKN_SEL_JOB_NUMBER, /* Token ID */ (char *) &jobnum /* Token value */ ); if (spi_err != ZSPI_ERR_OK) stopwitherror(spi_err, (char *) &essputtkn); /* Do WriteRead to scheduler */ retcode = send_spi(); if (retcode != 0) stopwitherror(retcode, (char *) &eretcode); } #pragma page /* *-------------------------------------------------------------------* closedown * Use: * Part of finalization * Effects
PAGE 393
Sample C Program Sample Programs * *-------------------------------------------------------------------*/ main() { char *cptr; int jobnumber; zbat_ddl_netbatch_name_def name */ jobname; /* NetBatch definition for job /* Initialize the subsystem IDs */ cptr = strncpy(zbat_val_ssid.u_z_fill.z_fill, ZSPI_VAL_TANDEM, 8); zbat_val_ssid.z_number = ZSPI_SSN_ZBAT; zbat_val_ssid.
PAGE 394
Sample C Program Sample Programs /* Get the job-name token returned in the SPI buffer */ spi_err = SSGETTKN ( (short *) spi_buff, (long) (char *) ZBAT_TKN_SEL_JOBNAME, &work_area, 1 ); if (spi_err != ZSPI_ERR_OK) stopwitherror(spi_err, (char *) &essgettkn); cptr = strncpy (jobname.u_z_c.z_c, work_area.str, work_area.len); printf(" Job name : %s\n\n", jobname.u_z_c.
PAGE 395
Sample COBOL Program Sample Programs Sample COBOL Program Example C-2 on page C-17 contains the source code for a sample COBOL program. The program submits a job to a scheduler, executes a STATUS JOB command on the submitted job, and displays some job details. The source code for the program is available in the file NBSPIEX in the NetBatch installation subvolume. To run the sample program, follow these steps.
PAGE 396
Sample COBOL Program Sample Programs Step 4: Change Class Name Change class name CLASS-A to that of an existing class in $ZBAT if class CLASS-A does not exist in that scheduler. Otherwise, add class CLASS-A to $ZBAT. *CHANGE /"CLASS-A"/"OPERATIONS"/ ALL 904 MOVE "OPERATIONS" TO ZCLASSNAME OF ZBAT-DDLDEF-JOB. Step 5: Change Job Name Change job name MASTER-A to your own choice of name if MASTER-A conflicts with an existing production job in $ZBAT. Otherwise, delete job MASTER-A from $ZBAT.
PAGE 397
Sample COBOL Program Sample Programs Example C-2. Sample SPI COBOL Program ?ENV COMMON ?COMPACT, SYMBOLS, INSPECT, SAVE STARTUP ?SEARCH $SYSTEM.SYSTEM.COBOLLIB ?CONSULT $SYSTEM.SYSTEM.COBOLEX0 ?MAIN SPIEXCOB IDENTIFICATION DIVISION. PROGRAM-ID. DATE-WRITTEN. DATE-COMPILED. SPIEXCOB. November 1993.
PAGE 398
Sample COBOL Program Sample Programs *************************************************************** * Working-storage constants * *************************************************************** / ?NOLIST ?SOURCE $ISV.ZSPIDEF.ZBATCOB (ZBAT-TKN-SPI, ? ZBAT-TKN-EMS, ? ? ? ZBAT-DDL-NETBATCH-NAME, ZBAT-MAP-STATUS-JOB, ZBAT-DDL-STATUS-JOB, ? ? ZBAT-VAL-SSID, ZBAT-MAP-DEF-JOB, ? ? / ?SOURCE $ISV.ZSPIDEF.ZSPICOB ?LIST / 01 W02-WORK-AREA.
PAGE 399
Sample COBOL Program Sample Programs 03 03 03 03 03 01 FILLER PIC X(75) "SSPUT Failed FILLER PIC X(75) "GETSTARTUPTEXT Failed FILLER PIC X(75) "SSNULL Failed FILLER PIC X(75) "NUMIN Failed FILLER PIC X(75) "RETCODE indicated a NetBatch error W07-ERROR-MESSAGES-ARRAY 03 W07-ERROR-TEXT REDEFINES VALUE ". VALUE ". VALUE ". VALUE ". VALUE W07-ERROR-MESSAGES. PIC X(75) OCCURS 8 TIMES. PROCEDURE DIVISION. /M A I N L I N E A000-MAINLINE ". S P I E X C O B SECTION. PERFORM A000-INIT. PERFORM A000-MAIN.
PAGE 400
Sample COBOL Program Sample Programs * Open the scheduler OPEN I-O SCHED-FILE. IF W03-SCHED-STATUS NOT = "00" MOVE 0 TO W05-STATUS MOVE SPACES TO W03-ERROR-TEXT STRING "OPEN " DELIMITED BY SIZE W07-ERROR-TEXT(1) DELIMITED BY ":" " " W03-SCHED-STATUS DELIMITED BY SIZE DELIMITED BY SIZE INTO W03-ERROR-TEXT END-STRING CALL "SPIEXABN" USING W05-STATUS, W03-ERROR-TEXT END-IF. A000-A90-EXIT. EXIT. / *************************************************************** A000-MAIN SECTION.
PAGE 401
Sample COBOL Program Sample Programs * Get the job-name token and display on screen ENTER TAL "SSGET" USING ZBAT-DDL-MSG-BUFFER, ZBAT-TKN-SEL-JOBNAME, ZBAT-DDL-NETBATCH-NAME, 1 GIVING W05-STATUS. IF W05-STATUS NOT = 0 CALL "SPIEXABN" USING W05-STATUS, W07-ERROR-TEXT(2) END-IF. DISPLAY " Job name : " ZBAT-DDL-NETBATCH-NAME. * Get the status of the job PERFORM B100-STATUS-JOB. ENTER TAL "SSGET" USING ZBAT-DDL-MSG-BUFFER, ZBAT-MAP-STATUS-JOB, ZBAT-DDL-STATUS-JOB, 1 GIVING W05-STATUS.
PAGE 402
Sample COBOL Program Sample Programs * Initialize the SPI buffer ENTER TAL "SSINIT" USING ZBAT-DDL-MSG-BUFFER, ZBAT-VAL-BUFLEN, ZBAT-VAL-SSID, ZSPI-VAL-CMDHDR, ZBAT-CMD-SUBMIT, ZBAT-OBJ-JOB, 0, OMITTED, W02-TRUE GIVING W05-STATUS. IF W05-STATUS NOT = 0 CALL "SPIEXABN" USING W05-STATUS, W07-ERROR-TEXT(3) END-IF. DISPLAY " Job name : " ZBAT-DDL-NETBATCH-NAME. * Get the status of the job PERFORM B100-STATUS-JOB.
PAGE 403
Sample COBOL Program Sample Programs *############################################################## *# This section: # *# a) Initializes the SPI buffer # *# b) Inserts tokens necessary to submit the job # *# c) Submits the job # *############################################################## * Initialize the SPI buffer ENTER TAL "SSINIT" USING ZBAT-DDL-MSG-BUFFER, ZBAT-VAL-BUFLEN, ZBAT-VAL-SSID, ZSPI-VAL-CMDHDR, ZBAT-CMD-SUBMIT, ZBAT-OBJ-JOB, 0, OMITTED, W02-TRUE GIVING W05-STATUS.
PAGE 404
Sample COBOL Program Sample Programs ENTER TAL "SSPUT" USING ZBAT-DDL-MSG-BUFFER, ZBAT-TKN-EXECUTOR-PROGRAM, W05-DATA-STRUCT GIVING W05-STATUS. IF W05-STATUS NOT = 0 CALL "SPIEXABN" USING W05-STATUS, W07-ERROR-TEXT(4) END-IF. * Insert volume-subvol token MOVE 1 TO W05-DATA-LEN. MOVE SPACES TO W05-DATA-AREA. STRING W02-TEXT DELIMITED BY SPACE INTO W05-DATA-AREA WITH POINTER W05-DATA-LEN END-STRING. SUBTRACT 1 FROM W05-DATA-LEN.
PAGE 405
Sample COBOL Program Sample Programs INTO W05-DATA-AREA WITH POINTER W05-DATA-LEN END-STRING. SUBTRACT 1 FROM W05-DATA-LEN. ENTER TAL "SSPUT" USING ZBAT-DDL-MSG-BUFFER, ZBAT-TKN-OUT-FILE, W05-DATA-STRUCT GIVING W05-STATUS. IF W05-STATUS NOT = 0 CALL "SPIEXABN" USING W05-STATUS, W07-ERROR-TEXT(4) END-IF. * Initialize the job structure ENTER TAL "SSNULL" USING ZBAT-MAP-DEF-JOB, ZBAT-DDL-DEF-JOB GIVING W05-STATUS. IF W05-STATUS NOT = 0 CALL "SPIEXABN" USING W05-STATUS, W07-ERROR-TEXT(6) END-IF.
PAGE 406
Sample COBOL Program Sample Programs B000-B99-EXIT. EXIT. / *************************************************************** B100-STATUS-JOB SECTION.
PAGE 407
Sample COBOL Program Sample Programs * Write the SPI buffer to the scheduler READ SCHED-FILE WITH PROMPT ZBAT-DDL-MSG-BUFFER END-READ. IF W03-SCHED-STATUS NOT = "00" MOVE 0 TO W05-STATUS MOVE SPACES TO W03-ERROR-TEXT STRING "READ " DELIMITED BY SIZE W07-ERROR-TEXT(1) DELIMITED BY ":" " " DELIMITED BY SIZE W03-SCHED-STATUS DELIMITED BY SIZE INTO W03-ERROR-TEXT END-STRING CALL "SPIEXABN" USING W05-STATUS, W03-ERROR-TEXT END-IF.
PAGE 408
Sample COBOL Program Sample Programs / *************************************************************** * * START PROGRAM SPIEXABN * * *************************************************************** IDENTIFICATION DIVISION. PROGRAM-ID. DATE-WRITTEN. DATE-COMPILED. SPIEXABN. 16/11/93. * * OVERVIEW: *############################################################## *# # *# This program is the error handling routine for SPIEXCOB.
PAGE 409
Sample COBOL Program Sample Programs *************************************************************** A000-PROCESS-ERROR SECTION. ENTER TAL "PROCESS_STOP_" USING OMITTED, OMITTED, OMITTED, 2, W01-ERROR-CODE, OMITTED, W01-ERROR-TEXT. A000-A00-EXIT. EXIT.
PAGE 410
Sample TACL Macros Sample Programs Sample TACL Macros Example C-3 on page C-32 contains the source code for sample TACL macros. The macros submit a job to a scheduler, execute a STATUS JOB command on the submitted job, and display some of the job’s details. The source code for the macros is available in the file NBSPIEX in the NetBatch installation subvolume. To run the sample macros, follow these steps.
PAGE 411
Sample TACL Macros Sample Programs Step 5: Load Macros From Source File End the EDIT session and load the macros from the source file you created at Step 1: *EXIT > LOAD /KEEP 1/ TEMP.TACLSRC Loaded from $DATA7.TEMP.
PAGE 412
Sample TACL Macros Sample Programs Example C-3. Sample SPI TACL Macros ?SECTION spiextacl ROUTINE == #################################################################### == == # # == == # This TACL macro demonstrates the subsystem programmatic # == == # interface (SPI)to the NetBatch scheduler.
PAGE 413
Sample TACL Macros Sample Programs INT jobnumber; END; ] == Define work-area data structure [#DEF data^struct STRUCT BEGIN INT data^len; STRUCT data^area; BEGIN CHAR BYTE(0:23); END; END; ] == Submit a job #SET ss^error [submit^job] [#IF ss^error |THEN| #RETURN ] == Get job-number token and display on screen #SETMANY zbat^ss^status, [#SSGETV /INDEX 1/ zbat^spi^buffer zbat^tkn^sel^job^number zbat^jobnumber ] [#IF zbat^ss^status |THEN| #OUTPUT Termination Info: [zbat^ss^status] #OUTPUT SSGETV Failed #RETURN
PAGE 414
Sample TACL Macros Sample Programs #OUTPUT /COLUMN 17/ Job name : [data^struct:data^area] == Get the status of the job #SET ss^error [status^job] [#IF ss^error |THEN| #RETURN ] #SETMANY zbat^ss^status, [#SSGETV /INDEX 1/ zbat^spi^buffer zbat^map^status^job zbat^job^status ] [#IF zbat^ss^status |THEN| #OUTPUT Termination Info: [zbat^ss^status] #OUTPUT SSGETV Failed #RETURN ] == Display the status of the job on screen #OUTPUT #OUTPUT /COLUMN 4/ Job status from [schd] using SPI #OUTPUT #OUTPUT /COLUMN 17/
PAGE 415
Sample TACL Macros Sample Programs == Initialize the SPI buffer #SET zbat^ss^status [#SSINIT zbat^spi^buffer [zbat^val^ssid] [zbat^cmd^submit] /OBJECT [zbat^obj^job], CHECKSUM -1/ ] [#IF zbat^ss^status |THEN| #OUTPUT Termination Info: [zbat^ss^status] #OUTPUT SSINIT Failed #RESULT -1 #UNFRAME #RETURN ] == Insert job-name token #SET #SET #SET #SET data^struct:data^area MASTER-A work^area [data^struct:data^area] data^struct:data^len [#CHARCOUNT work^area] zbat^ss^status [#SSPUTV zbat^spi^buffer zbat^tkn^se
PAGE 416
Sample TACL Macros Sample Programs #SET data^struct:data^len [#CHARCOUNT work^area] #SET zbat^ss^status [#SSPUTV zbat^spi^buffer zbat^tkn^volume^subvol data^struct ] [#IF zbat^ss^status |THEN| #OUTPUT Termination Info: [zbat^ss^status] #OUTPUT SSPUTV Failed #RESULT -1 #RETURN ] == Insert in-file token #PUSH infile^name #SET work^area #SET infile^name .
PAGE 417
Sample TACL Macros Sample Programs [#IF zbat^ss^status |THEN| #OUTPUT Termination Info: [zbat^ss^status] #OUTPUT SSNULL Failed #RESULT -1 #RETURN ] == Set job attributes #SET zbat^job^def:zclassname:z^c #SET zbat^job^def:zhold #SET zbat^job^def:zhold^after #SET zbat^job^def:zdefault^security CLASS-A -1 -1 2340 == True == True == Security "NNNN" == Put job structure details into SPI buffer #SET zbat^ss^status [#SSPUTV zbat^spi^buffer zbat^map^def^job zbat^job^def ] [#IF zbat^ss^status |THEN| #OUTPUT Ter
PAGE 418
Sample TACL Macros Sample Programs [#IF zbat^ss^status |THEN| #OUTPUT Termination Info: [zbat^ss^status] #OUTPUT SSINIT Failed #RESULT -1 #RETURN ] == Insert job-number token #SET zbat^ss^status [#SSPUTV zbat^spi^buffer zbat^tkn^sel^job^number zbat^jobnumber ] [#IF zbat^ss^status |THEN| #OUTPUT Termination Info: [zbat^ss^status] #OUTPUT SSPUTV Failed #RESULT -1 #RETURN ] == Get job status #SET zbat^all^done 0 [#LOOP |DO| wait^for^it |UNTIL| zbat^all^done ] [#IF zbat^wait^for^it^result |THEN| #OUTPUT Termi
PAGE 419
Sample TACL Macros Sample Programs #SET req^error [#REQUESTER /WAIT [zbat^val^buflen]/ READ [schd].
PAGE 420
Sample TACL Macros Sample Programs ================================================================= ?SECTION wait^for^it MACRO == ########################################################### == == == == This macro: == == a) Interprets the responses from the scheduler == == == == ########################################################### == #SET zbat^wait^for^it^result 0 == Get the data returned from the scheduler [#CASE [#VARIABLEINFO /VARIABLE/ [#WAIT zbat^error^var zbat^data^var zbat^prompt^var ]] |zba
PAGE 421
Sample TAL Program Sample Programs Sample TAL Program Example C-4 on page C-42 contains the source code for a sample TAL program. The program submits a job to a scheduler, executes a STATUS JOB command on the submitted job, and displays some job details. The source code for the program is available in the file NBSPIEX in the NetBatch installation subvolume. To run the sample program, follow these steps.
PAGE 422
Sample TAL Program Sample Programs Step 5: Compile the Source File End the EDIT session and compile the source file: *EXIT > TAL /IN TEMP.TALSRC/ TEMP.TALOBJ; SUPPRESS Step 6: Test the Program Test the program by running the compiled object: > RUN TEMP.TALOBJ Job submitted to $ZBAT using SPI Job number : 008 Job name : TAL-JOB Job status from $ZBAT using SPI Selpri : 3 Class : OPERATIONS Step 7: Delete the Submitted Job > BATCHCOM $ZBAT; DELETE JOB TAL-JOB Job TAL-JOB Jobnumber 8 deleted Example C-4.
PAGE 423
Sample TAL Program Sample Programs -- Global declarations INT .spi^buf[0:((zbat^val^buflen^min+6)/2)]; INT .zbat^val^ssid^init[0:5] := [zspi^val^tandem, zspi^ssn^zbat, zbat^val^version]; INT work^length[0:Maxfilewords]; -- Common work buffer STRING work^area = work^length[1]; INT .temp[0:11]; INT .sm[0:66]; -- Startup message buffer word pointer STRING .
PAGE 424
Sample TAL Program Sample Programs CALL FILE_GETINFO_(schd_chan, error); stopwitherror(ewrite_readx_, 16); END; -- Read tokens returned in SPI buffer IF error := SSGETTKN(spi^buf , zspi^tkn^retcode , retcode , 1) THEN stopwitherror(essget, 12); RETURN retcode; END; --------------------------------------------------------------------------------------------------- SUBMIT^JOB function procedure. -- This function procedure formats the SPI buffer for NetBatch -- and submits a job to $ZBAT.
PAGE 425
Sample TAL Program Sample Programs work^length := @ptr '-' @work^area; IF (error := SSPUTTKN(spi^buf, zbat^tkn^executor^program, work^length)) THEN stopwitherror(essput, 12); -- Insertvolume-subvol token temp ':=' sm[_defaults] for 8 & "INFILE ";-- Get .
PAGE 426
Sample TAL Program Sample Programs INT BEGIN INT .
PAGE 427
Sample TAL Program Sample Programs CALL READX(recv_chan, sm, ($OCCURS(sm)*$LEN(sm))); CALL FILE_CLOSE_(recv_chan); -- Convert C-series file name to D-series format error := OLDFILENAME_TO_FILENAME_(sm[_out], work^area:maxfilebytes, work^length); -- Open OUT file IF error OR (error := FILE_OPEN_(work^area:work^length, out_chan)) THEN stopwitherror(efile_open_, 16); -- Open the scheduler IF (error := FILE_OPEN_(scheduler^name:11, schd_chan)) THEN stopwitherror(efile_open_, 16); -- Format the SPI structure a
PAGE 428
Sample TAL Program Sample Programs buffer ':=' " Job name : " & ascii^num for 12 & %H0A0D & %H0A0D -> @ptr; CALL WRITE(out_chan, buffer, @ptr '-' @buffer); END; -- Format the SPI buffer and get the status of the job IF (error := status^job(jobnumber)) THEN stopwitherror(eretcod, 34) ELSE BEGIN IF error := SSGET(spi^buf , job^status^map , job^stat , 1) THEN stopwitherror(essget, 12); -- Read tokens returned -- Job status output header message buffer ':=' " Job status from $ZBAT using SPI" & %H0A0D ->
PAGE 429
Glossary abend. An acronym for abnormal end (of a process). ASSIGN. A parameter that assigns the name of an actual file to a logical file name in a program. It also can specify the file’s creation and open attributes. For more information, see the TACL Reference Manual and the TACL Programming Guide. attachment set. A named set of ASSIGNs, DEFINEs, and PARAMs. attribute. A characteristic of an entity (for example, the selection priority of a job).
PAGE 430
command number Glossary command number. A number representing a particular command to a subsystem. Each subsystem or management process with a token-oriented programmatic interface can have its own set of command numbers, represented in DDL by constants and in programs by TAL LITERAL or DEFINE declarations, COBOL level-01 variables, C #define directives, or TACL text variables. The command number is a header token in command and response messages. completion code.
PAGE 431
continuation Glossary continuation. The packaging of a response in multiple response messages. The subsystem uses a context token to indicate that the response is continued to another message. Each response message can contain multiple response records, but a single response record cannot span two response messages. control and inquiry. Those aspects of object management related to the state or configuration of an object.
PAGE 432
definition files Glossary definition files. A set of files containing declarations for use in applications that call SPI procedures. SPI has a standard definition file for DDL and one for each programming language supporting SPI. The latter files are derived from the DDL definition file. Similarly, each subsystem with a token-oriented programmatic interface has one definition file for DDL and one for each programming language.
PAGE 433
EMS standard definitions Glossary EMS standard definitions. The set of declarations provided by EMS for use in event management regardless of the subsystem. Any application that retrieves tokens from event messages needs the EMS standard definitions. Names of EMS standard definitions start with ZEMS. See also definition; definition files; SPI standard definitions. end-list token. A syntax token that ends a list. SPI defines a single end-list token, whose token code is ZSPI-TKN-ENDLIST.
PAGE 434
event message Glossary event message. (1) In programmatic interfaces based on SPI, a special type of SPI message that describes an event occurring in the system. (2) In the ViewPoint console application, the displayed form of such a message, shown as one text line. executor. A logical entity in the scheduler. An executor’s purpose is to link jobs through their classes to a processor.
PAGE 435
header token Glossary header token. A special token type containing information about an SPI message.
PAGE 436
job Glossary job. A process or a sequence of processes that performs specified tasks. All NetBatch jobs have an executor program and, depending on the program, an input file. The input file contains commands executed by the executor program, which the NetBatch scheduler starts as the job’s initial process. The executor-program process can start other processes after the initial process has been started. list.
PAGE 437
maximum field version Glossary maximum field version. In an SPI message, the latest version associated with any non-null field of any extensible structured token in the message. The maximum field version of the SPI message is contained in a header token. It corresponds to the version of the oldest server or requester that can successfully process the message. message. A block of information, usually in the form of a structure, that is sent from one process to another. See also SPI message. message buffer.
PAGE 438
null object type Glossary null object type. A place-holder object type that management applications can use in programmatic commands that do not require explicit specification of a particular object type. null value. A value indicating that a program has made no explicit assignment to a variable or field. For SPI, a field of a structure has a null value if the application has made no explicit assignment to that field after calling the SSNULL procedure to initialize the structure. object.
PAGE 439
parameter token Glossary parameter token. (1) In control and inquiry, a token supplying parameter information for a command. Most tokens in a command message are parameter tokens. Depending on the subsystem, they can include attribute tokens, object-selector or object-name tokens, and subsystem-control tokens. See also syntax token. (2) In event management, a token representing a parameter passed by an application to an eventmessage filter. Such tokens are kept in a parameter buffer.
PAGE 440
response message Glossary response message. An SPI message that is sent from a subsystem to an application program in reaction to a command message. See SPI message; command message. response record. A set of response tokens, usually describing the results of performing a command on one object. A response can consist of multiple response records, distributed among one or more response messages.
PAGE 441
scheduler Glossary scheduler. A process-pair server that stores job records in its database, schedules and starts jobs, monitors their execution, and records job termination details. The scheduler’s program file is NETBATCH and its command interface BATCHCOM. The scheduler queues jobs according to the jobs’ scheduling criteria and dependencies. It starts the jobs’ executor programs, monitors job execution, and acts as a home terminal for the jobs’ processes.
PAGE 442
SPI Glossary SPI. A set of procedures and associated definition files used to define common messagebased interfaces for communication between requesters and serversfor instance, in a management application.
PAGE 443
SPI standard definitions Glossary SPI standard definitions. Declarations available for use with SPI procedures. There also are subsystem-specific declarations for each subsystem, and some declarations that apply to multiple subsystems. An application using SPI needs the SPI standard definitions and the subsystem definitions for all subsystems with which it communicates. Names of SPI standard definitions start with ZSPI.
PAGE 444
subsystem version number Glossary subsystem version number. A 16-bit integer representing the software release version of a subsystem. The subsystem version number is a field of the subsystem ID. If its value is null (zero), the subsystem ID refers to any and all versions of the subsystem. See version number. subsystem-control token. A parameter token that influences how a subsystem performs a command.
PAGE 445
token Glossary token. (1) In SPI, a distinguishable unit in an SPI message. Programs place tokens in an SPI buffer using the SSPUT procedure (except for header tokens, which are a special case), and retrieve them from the buffer with the SSGET procedure. A token has two parts: an identifying code, or token code, and a token value. For command and response messages, a token normally represents a parameter to a command, an item of information in a response, or control information for the subsystem.
PAGE 446
Transaction Application Language (TAL) Glossary Transaction Application Language (TAL). See TAL. TSVs. Subvolumes containing product files updated from a distribution subvolume by DSM/SCM, the software configuration manager. unconditional token. A token that is always present in a particular event message. See also conditional token. upward compatibility. The ability of a requester to operate with a server of a higher revision level.
PAGE 447
Index Numbers 204 (event message ZBAT-EVT-JOBOVER-LIMIT), description of 6-18/6-19 23:59:59:999.
PAGE 448
A Index Attributes (continued) DEFAULT-MAXPRINTPAGES See ZMAXPRINTPAGES field, of ZBAT-MAP-DEF-SCHEDULER DEFAULT-OUT See ZBAT-TKN-, OUT-FILE DEFAULT-PRI See ZPRI field, of ZBAT-MAP-DEFSCHEDULER DEFAULT-SELPRI See ZSELPRI field, of ZBAT-MAPDEF-SCHEDULER DEFAULT-STALL See ZSTALL field, of ZBAT-MAPDEF-SCHEDULER DEFAULT-STOP-ON-ABEND See ZSTOP-ON-ABEND field, of ZBAT-MAP-DEF-SCHEDULER DEFINE See ZBAT-TKN-, ATT-SET-DEFINE definition of Glossary-1 DESCRIPTION See ZBAT-TKN-, DESCRIPTION EMS See ZEMS field EVERY
PAGE 449
B Index Attributes (continued) See ZPFS field PRI See ZPRI field, of ZBAT-MAP-DEFJOB PURGE-IN-FILE See ZPURGE-IN-FILE field RESTART See ZRESTART field RUND See ZRUND field SAVEABEND See ZSAVEABEND field SECURITY See ZBAT-TKN-, ATT-SETSECURITY SELPRI See ZSELPRI field, of ZBAT-MAPDEF-JOB STALL See ZSTALL field, of ZBAT-MAPDEF-JOB STARTUP See ZBAT-TKN-, STARTUPMESSAGE STOP-ON-ABEND See ZSTOP-ON-ABEND field, of ZBAT-MAP-DEF-JOB SUBMIT-ALLOWED See ZSUBMIT-ALLOWED field SWAP See ZBAT-TKN-, SWAP-FILE TAPEDRIVES
PAGE 450
C Index C C programming language define directives representing command numbers Glossary-2 representing object-type numbers Glossary-10 sample programs, SPI C-2 Calendar See Run calendar CALENDAR job attribute See ZBAT-TKN-, CALENDAR CATCHUP scheduler attribute See ZEVERY-CATCHUP field Class attribute, INITIATION (ZINITIATION field of ZBAT-MAP-DEF-CLASS) 4-49 definition of Glossary-1 states See ZJOBCLASS field class Glossary-1 CLASS executor attribute See ZCLASSNAME field, of ZCLASSES in ZBAT-MAP-DEFEXECU
PAGE 451
D Index D Data Definition Language (DDL) See DDL Data lists, definition of Glossary-3 Data-portion token, definition of Glossary-3 DDL (Data Definition Language), definitions and token maps, table of B-5/B-12 Decoding response messages 3-7 DEFAULT-CLASS scheduler attribute See ZCLASSNAME field, of ZBATMAP-DEF-SCHEDULER DEFAULT-EXECUTOR-PROGRAM scheduler attribute See ZBAT-TKN-, EXECUTORPROGRAM DEFAULT-HIGHPIN scheduler attribute See ZHIGHPIN field, of ZBAT-MAPDEF-SCHEDULER DEFAULT-MAXPRINTLINES scheduler
PAGE 452
E Index DSM (Distributed Systems Management) (continued) programmatic interfaces, list of -xvii See also DSM Template Services template-lookup key 4-42 DSV (distribution subvolume), definition of Glossary-4 E Edit code, MSG 4-42 EMS parameter, in RUN NETBATCH command 6-3 EMS scheduler attribute See ZEMS field EMS (Event Management Service) collector ($0) 6-3 definition of Glossary-4 EMS parameter, NETBATCH program 6-3 EMSTEXT procedure 6-5 event messages, descriptions of 204, ZBAT-EVT-JOB-OVERLIMIT 6-18/
PAGE 453
F Index Executor attributes CLASS (ZCLASSES field of ZBATMAP-DEF-EXECUTOR) 4-51 CPU (ZCPU field of ZBAT-MAPDEF-EXECUTOR) 4-51 definition of Glossary-6 states ACTIVE 4-35 DELETE 4-36 DOWN 4-36 OFF 4-36 ON 4-36 STOP 4-36 Executor program, definition of Glossary-6 EXECUTOR-PROGRAM job attribute See ZBAT-TKN-, EXECUTORPROGRAM Explicit command, definition of Glossary-6 Extensible structured tokens, definition of Glossary-6 Extensible Structured Tokens, table of 4-11 Extensible structure, definition of Glossary
PAGE 454
J Index INITIATION scheduler attribute See ZINITIATION field, of ZBAT-MAPDEF-SCHEDULER Installation subvolumes (ISVs) See ISVs Installing filters 6-3 Interactive commands versus programmatic commands, table of 1-6 Interactive session See Session ISVs (installation subvolumes), definition of Glossary-18 J Job attributes AFTER (ZAT-FLAG field of ZBATMAP-DEF-JOB) 4-53 AT (ZAT-FLAG field of ZBAT-MAPDEF-JOB) 4-53 ATTACHMENT-SET (ZBAT-TKNATT-SET-ID) 4-40 CALENDAR (ZBAT-TKNCALENDAR) 4-42 CLASS (ZCLASSNAME field
PAGE 455
L Index Job (continued) SWAP (ZBAT-TKN-SWAPFILE) 4-47 TAPEDRIVES (ZTAPEDRIVES field of ZBAT-MAP-DEF-JOB) 4-56 TERM (ZBAT-TKN-TERMFILE) 4-47 WAITON (ZBAT-DDL-WAITONFOR, ZBAT-DDL-WAITONINDICATOR, ZBAT-MAP-DEFWAITON) 4-32, 4-62 definition of Glossary-8 dependency, definition of Glossary-4 See also ZBAT-DDL-, WAITONFOR; ZBAT-DDL-, WAITONINDICATOR; ZBAT-MAP-, DEFWAITON dependent, definition of Glossary-4 See also ZBAT-DDL-, WAITONFOR; ZBAT-DDL-, WAITONINDICATOR; ZBAT-MAP-, DEFWAITON input file, definition of G
PAGE 456
N Index MAXPRINTLINES job attribute See ZMAXPRINTLINES field, of ZBATMAP-DEF-JOB MAXPRINTPAGES job attribute See ZMAXPRINTPAGES field, of ZBATMAP-DEF-JOB MAX-CONCURRENT-JOBS scheduler attribute See ZMAXCONCURRENTJOBS field; ZMAXTEMPEXECUTORS field 4-60 MAX-PRI scheduler attribute See ZMAXPRI field MEM job attribute See ZMEM field Message buffer definition of Glossary-9 Message buffer, definition of See also Buffers Message code, definition of Glossary-9 Messages definition of Glossary-9 event See Event me
PAGE 457
O Index NetBatch product (continued) subsystem communicating with, steps in 2-1 error lists issued by A-1 error numbers issued by A-1 overview 1-2 tokens, codes and types, table of B-2/B-4 tokens, maps and DDL definitions, table of B-5/B-12 NETBATCH program core component of NetBatch product 1-2 definition of 1-2, Glossary-9 EMS parameter 6-3 running interactively 2-2 See also NetBatch product NetBatch supervisor, definition of Glossary-9 NetBatch-Plus, definition of Glossary-9 Next position, definition o
PAGE 458
R Index PRI job attribute See ZPRI field, of ZBAT-MAP-DEF-JOB Printing distributor definition of Glossary-11 Printing distributor, definition of See also Distributor Private token and field types, table of 4-8 Private token type, definition of Glossary-11 Procedural interface, definition of Glossary-11 Procedure calls Guardian ABEND 4-42, 4-48, 6-2, 6-3, 6-15, 6-18, 6-19 CONVERTTIMESTAMP A-71 DEFINESETATTR 4-64 DEFINEVALIDATEWORK 4-64 EMSTEXT 6-5 PROCESS_CREATE_ 4-20, 4-44, 6-20, 6-24 PROCESS_STOP_ 4-42,
PAGE 459
S Index processes (continued) LIB See ZBAT-TKN-, LIB-FILE MEM See ZMEM field NAME See ZNAME field OUT See ZBAT-TKN-, OUT-FILE PFS See ZPFS field PRI See ZPRI field, of ZBAT-MAP-DEFJOB SAVEABEND (INSPECT run-option value) See ZSAVEABEND field SWAP See ZBAT-TKN-, SWAP-FILE TERM See ZBAT-TKN-, TERM-FILE Run time, job, definition of Glossary-12 See also ZDATE field; ZTIME field Glossary-12 RUND job attribute See ZRUND field RUNNEXT job state 4-36, 4-37 RUNNOW job state 4-37 S Sample programs, SPI TACL C-32/C
PAGE 460
S Index Scheduler (continued) MAX-CONCURRENT-JOBS (ZMAXCONCURRENTJOBS and ZMAXTEMPEXECUTORS fields of ZBAT-MAP-DEFSCHEDULER) 4-60 MAX-PRI (ZMAXPRI field of ZBATMAP-DEF-SCHEDULER) 4-60 SUBMIT-ALLOWED (ZSUBMITALLOWED field of ZBAT-MAP-DEFSCHEDULER) 4-61 TAPEDRIVES (ZTAPEDRIVES field of ZBAT-MAP-DEFSCHEDULER) 4-60 configuration file See ZBAT-TKN-, BATCHCTL definition of 1-2, Glossary-13 See also NETBATCH program startup 2-2 SECURITY attachment-set attribute See ZBAT-TKN-, ATT-SET-SECURITY SELPRI job attribut
PAGE 461
T Index Subjects, definition of Glossary-15 SUBMIT-ALLOWED scheduler attribute See ZSUBMIT-ALLOWED field Subsystem definition of Glossary-15 definitions, definition of Glossary-15 ID, definition of Glossary-15 number, definition of Glossary-15 owner definition of Glossary-15 for NetBatch subsystem Glossary-15 version number, definition of Glossary-16 Subsystem Programmatic Interface (SPI) See EMS interface; NB^JOB^SUBMIT; SPI Subsystem-control token, definition of Glossary-16 Supervisor, NetBatch, definit
PAGE 462
U Index Tokens (continued) data-portion, definition of Glossary-3 DDL definitions, of token maps, table of B-5/B-12 defined by SPI 4-2/4-5 definition of Glossary-17 end-list, definition of Glossary-5 error, definition of Glossary-5 extensible structured, definition of Glossary-6 header 4-2 definition of Glossary-6 information, definition of Glossary-7 length, definition of Glossary-17 list, definition of Glossary-8 maps and DDL definitions, table of B-5/B-12 map, definition of Glossary-17 number, definiti
PAGE 463
Z Index ZACTIVE field of ZEXECUTOR in ZBAT-MAPSTATUS-SCHEDULER 4-70 of ZPROCESS in ZBAT-MAP-STATUSSCHEDULER 4-72 ZADDR field 4-64 ZATTRLEN field 4-64 ZATTRTXT field 4-64 ZATT-SET-COUNT field 4-72 ZAT-ALLOWED field 4-60 ZAT-FLAG field 4-53 ZBACKUPCPU1 field 4-60 See also ZBACKUPCPU2 field ZBACKUPCPU2 field 4-59 See also ZBACKUPCPU1 field ZBAT-DDLDEFINE-ERROR 4-64 definitions, tables of 4-8, B-5/B-12 DEF-CLASS 4-49 DEF-CRONTAB 4-50 DEF-JOB 4-53 DEF-WAITON 4-63 OBJECT 4-19 PAR-RELEASE-JOB 4-19 PC-ERROR0 4-20
PAGE 464
Z Index ZBAT-ERR- (continued) MAXPRINTPAGES A-47 MAXTEMPEXECUTORS A-107 MEM A-101/A-102 MISSING-EXECUTOR A-86 MULTIPLE-CONTEXT A-49 NETBATCH-NAME A-80/A-81 NODENAME A-104/A-105 NOT-IMPLEMENTED A-78 NO-SUBMIT A-52 NO-SUCH-EXECUTOR A-37 NO-SUCH-JOB A-41 PFS A-108 POSIX A-99 PRI A-56 PURGE-IN-FILE A-98 RESTART A-56 RUND A-100 RUNNEXT A-58 RUNNEXT-RUNNOW A-59 SAVEABEND A-99 SECURITY A-54 SELPRI A-61 SHUTDOWN A-54 STOP A-83 SUSPEND A-81 SWITCHCPU A-68 TIME A-85 TIME-LIMIT A-102 UNKNOWN-OBJECT A-65 USER-UNDEFIN
PAGE 465
Z Index ZBAT-MAP- (continued) structure 4-70 ZBAT-OBJvalues of 4-19 ZBAT-TKNATT-SET-ASSIGN 4-40 ATT-SET-DEFINE 4-40 ATT-SET-ID general description of 4-40 in ADD ATTACHMENT-SET command 5-12 in ALTER ATTACHMENT-SET command 5-18 ATT-SET-PARAM 4-40 ATT-SET-SECURITY 4-41 ATT-SET-TEMPORARY 4-41 BATCHCTL 4-41 BYTESTRING 4-41 CALENDAR 4-42 CHAR6 4-42 COMMAND 4-42 COMPLETION-CODE, general description of 4-42 DATA-BASE 4-42 definitions, table of 4-8/4-11, B-2/B-4 DESCRIPTION 4-42 EXECUTOR-ID 4-42 EXECUTOR-PROGRAM,
PAGE 466
Z Index ZBAT-TKN- (continued) in STATUS JOB command 5-57 SEL-JOB-NAME See ZBAT-TKN, SEL-JOBNAME SEL-JOB-NUMBER, general description of 4-45 SEL-LIST 4-46 SEL-NETBATCH-NAME 4-46 SEL-NOTADPNAME 4-46 SEL-NOTCLASSNAME 4-46 SEL-NOTINNAME 4-46 SEL-NOTJOBNAME 4-46 SEL-NOTLIST 4-46 SEL-NOTUSERNAME 4-47 SEL-NOTWAITON 4-47 SEL-PARAM-NAME 4-47 SEL-USERNAME 4-47 SEL-WAITON 4-47 STARTUP-MESSAGE 4-47 START-TIME 4-47 STRING 4-47 SWAP-FILE 4-47 TERMINATION-INFO 4-48 TERM-FILE 4-47 TEXT 4-48 TIME-LIMIT 4-48 TOTAL-CPU-TIME
PAGE 467
Z Index ZBAT-VAL- (continued) JOB-TIME-LIST 4-37 LAST-LIST 4-37 See also ZBAT-VAL-, FIRST-LIST NEWPROCESS-ERROR 4-37 READY 4-37 RESTART-OFF 4-37 RESTART-ON 4-37 RUNNEXT 4-37 RUNNOW 4-37 SCHEDULER-ZNOTSTARTED 4-38 SCHEDULER-ZSHUTDOWN 4-38 SCHEDULER-ZSTARTED 4-38 SPECIAL-1 4-38 SPECIAL-2 4-38 SPECIAL-3 4-38 SPECIAL-4 4-38 SPECIAL-5 4-38 SPECIAL-6 4-38 SPECIAL-7 4-38 SPECIAL-8 4-38 SPECIAL-9 4-38 SPECIAL-ANY 4-38 SSID 4-39 STALL 4-39 SUSPENDED 4-39 TAPE 4-39 TIME 4-39 VERSION 4-39 WAITON-RELEASED-OK 4-39 WAI
PAGE 468
Z Index ZEXECPHANDLE field 4-69 ZEXECUTING field 4-71 ZEXECUTOR field of ZBAT-MAP-STATUS-JOB 4-68 of ZBAT-MAP-STATUSSCHEDULER 4-70 ZFOR field 4-63 ZGROUP field 4-67 ZHIGHPIN field of ZBAT-MAP-DEF-JOB 4-56 of ZBAT-MAP-DEF-SCHEDULER 4-62 ZHOLD field 4-53 ZHOLD-AFTER field 4-53 ZHOUR field 4-57 ZHOURS field 4-50 ZIFFAILS field 4-54 ZINDICATOR field 4-63 ZINFO-LAST-MOD field 4-58 ZINFO-LAST-MODUSER field 4-59 ZINFO-NEXT-RUNTIME field 4-54 ZINFO-OPEN-ACCESSOR field 4-54 ZINFO-OUT-SPOOL-NUM field 4-54 ZINFO-SPE
PAGE 469
Z Index ZPRI field of ZBAT-MAP-DEF-JOB 4-56 of ZBAT-MAP-DEF-SCHEDULER 4-61 ZPROCESS field 4-72 ZPURGE-IN-FILE field 4-54 ZREADY field 4-71 ZRELEASER field 4-65 ZREMID field of ZBAT-MAP-DEF-JOB 4-55 of ZBAT-MAP-STATUS-JOB 4-68 ZRESTART field 4-53 ZRUND field 4-58 ZRUNNEXT field 4-71 ZRUNNOW field 4-71 ZSAVEABEND field 4-58 ZSECOND field 4-57 ZSELPRI field of ZBAT-MAP-DEF-JOB 4-56 of ZBAT-MAP-DEF-SCHEDULER 4-61 of ZBAT-MAP-STATUS-JOB 4-67 ZSPECIAL field 4-71 ZSPECIAL-REASON field 4-68 ZSPI- definitions 4-2/
PAGE 470
Special Characters Index ZTIME-LIMIT field 4-59, 4-69 ZTIME-PREV-RUNTIME field 4-68 ZTIME-PUT-ON-LIST field 4-68 ZTIME-START field 4-68 ZTIME-SUBMIT field 4-69 ZTIME-USED field 4-68 ZUSER field 4-67 ZWEEKDAYS field 4-50 ZWHICH-LIST field of ZBAT-MAP-STATUSEXECUTOR 4-66 of ZBAT-MAP-STATUS-JOB 4-68 ZYEAR field 4-57 Special Characters $0, EMS collector 6-3 NetBatch Management Programming Manual—522462-003 Index -24