NetBatch Management Programming Manual

SPI Programming Considerations for the NetBatch

Subsystem

NetBatch Management Programming Manual—522462-003

3-4

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.

Commands

The NetBatch subsystem supports these programmatic commands:

Commands are identified by command numbers with symbolic names of the form

ZBAT-CMD-name or ZSPI-CMD-name, where name identifies the command. (The

separator character varies with the language. Hyphens appear in this and other DSM

manuals because DDL uses hyphens.) For example, the symbolic name of the ALTER

command is ZBAT-CMD-ALTER. Symbolic names represent the values that can be

assigned to the command-number header token, ZSPI-TKN-COMMAND.

For descriptions of NetBatch subsystem commands and the subsystem’s responses to

them, see Section 5, Commands and Responses.

Object Types

The NetBatch subsystem supports these object types:

All commands and responses contain an object-type token in the header. For the

NetBatch subsystem, object types are identified in programs by symbolic names of the

form ZBAT-OBJ-name, where name identifies the object type. For example, ZBAT-OBJ-

JOB represents the JOB object type. The object-type header token, ZSPI-TKN-

OBJECT-TYPE, always has one of these ZBAT values.

A response consists of several response records, which are groups of tokens that give

response information about a particular object.

Event Numbers

All event messages contain a header token identifying the event by number. This

number, with the subsystem-ID header token, uniquely identifies the event. Event

numbers for NetBatch event messages are identified in programs by symbolic names

ABORT GETVERSION SHUTDOWN SUBMIT

ACTIVATE INFO START SUSPEND

ADD RELEASE STATUS SWITCHCPU

ALTER RUNNEXT STOP SWITCHLOG

DELETE RUNNOW

ATT-SET EXECUTOR SCHEDULER

CLASS JOB