编译，链接，或运行

Synopsis

num list = BATCH/{COMPIL|LINK|RUN},file list[,LPT|,RLPT,'nodename'|,OS,'osfilespec'|,NULL][,QUEUE,'queue_name'][,STR,'string_data'][,IFERR,label:]

Description

Submits a batch job to the GRIP queue manager to be complied, linked, or executed.

NOTE: The COMPIL and LINK options are only available if you have a GRIP development license.

To trap operating system errors, such as compiling or running a non-existent file or a file you do not have access to, we recommend that you use the OS,'osfilespec' options. See the second example.

Parameters

Parameter

Description

COMPIL

Minor word which indicates that each member of the file list is to be compiled.

LINK

Minor word which indicates that each member of the file list is to be linked.

RUN

Minor word which indicates that each member of the file list is to be executed.

file list

For the COMPIL option, the file list may consist of main programs and/or subprograms. For the LINK option, the file list may contain only precompiled main programs. For the RUN option, the file list may contain only pre-linked main programs. The list may be a string array or it may consist of names in single quotes.

NOTE: If any of the programs being linked in a batch mode require subprograms which are in other directories, the filespec's for the subprograms must exist in a text file named gri.sea, which resides in the current directory (can also reside in the $UGII_UTIL directory).

LPT

Specifies the output will go to the system line printer.

RLPT

Specifies the output will go to a remote system's line printer.

'nodename'

The node name of the remote system.

OS

Specifies the output will go to an operating system file.

'osfilespec'

The output file specification for the operating system file.

NULL

Specifies the output will be suppressed.

QUEUE

Optional minor word which indicates that a batch queue name will be specified for the batch job. If no batch queue is specified and you are running interactive GRIP, the default queue is the queue set by the QUEUE option of the GRIP Batch menu.

NOTE: The QUEUE option is not supported on UNIX platforms.

'queue_name'

Optional string or string variable which specifies the name of the batch queue which will perform the batch operation.

If the batch queue specified is a system queue, that queue should be a serial queue.

STR

Minor word which indicates that a parameter string will be passed to the program.

'string_data'

A string containing the parameters that will be passed to the program. This parameter string will be returned by the GRIP GPA &GBSTR. The string may be a maximum of 132 characters.

On UNIX, this string should not contain dashes or spaces; On Windows 2000, if the string contains commas, enclose it in double quotes, e.g. ' "This, is, the, string" '.

IFERR,label:

Specifies a label to which the program jumps if an error occurs.