AFTER=expr Applies to: SD

Specifies a time when a SPOOLed or SUBMITted job should start. The expression provides a value for the time in DCL absolute or delta time format.

By default, the VMS job controller starts processing a SUBMITted or SPOOLed file as soon as system resources permit.

[NO]BURST Applies to: SPL

Enables or disables printing burst flags on a SPOOLed file.

By default, the queue controls whether to print burst flags.

CHARACTERISTIC=intexpr Applies to: S/S

Specifies a characteristic required of the queue for processing a SUBMITted or SPOOLed job. The expression supplies a single characteristic number. To specify multiple characteristics, use the CHARACTERISTIC deviceparameter more than once on the CLOSE.

The VMS system manager assigns queue CHARACTERISTICs. VMS gives CHARACTERISTICs both names and numbers. However, the CHARACTERISTIC deviceparameter only accepts numeric identifications.

By default, CLOSE does not limit the queue selection with characteristics.

Example:

	CLOSE sd:(SUBMIT:CHARACTERISTIC=4:CHAR=5)
	

This CLOSEs the device, and if the device is an RMS file, SUBMITs the file to batch, restricting the VMS job controller to execute the job in a queue with CHARACTERISTICs numbers 4 and 5.

CLI=expr Applies to: SUB

Specifies a command language for a SUBMITted job. The expression must name an available CLI.

By default, VMS uses the CLI identified by the account under which the job was SUBMITted, generally DCL.

COPIES=intexp Applies to: SPL

Specifies the number of copies of a SPOOLed file to print. The integer expression supplies a number of copies.

By default, the spooler prints one copy.

CPULIMIT=intexpr Applies to: S/S

Specifies the maximum CPU time a SPOOLed or SUBMITted job can consume before VMS terminates it. The integer expression supplies a time as a number of 10 millisecond increments. CPULIMIT=0 requests unlimited CPU time. This is analogous to the /CPUTIME qualifier on the DCL SUBMIT command.

By default, the account and/or the queue control the maximum CPU time.

DELETE Applies to: MBX SD FIFO

Instructs GT.M to delete the mailbox or the current version of the disk file after GT.M closes it. When the file is SPOOLed or SUBMITted, VMS deletes the file after processing it.

[NO]DOUBLESPACE Applies to: SPL

Enables or disables double spacing of a SPOOLed file.

By default, the spooler prints files single spaced.

EXCEPTION=expr Applies to: All devices

Defines an error handler for an I/O device. The expression must contain a fragment of GT.M code (for example, GOTO ERRFILE) that GT.M XECUTEs when the driver for the device detects an error, or an entryref to which GT.M transfers control, as appropriate for the current gtm_ztrap_form.

For more information on error handling, refer "Error Processing".

FIRSTPAGE=intexpr Applies to: SPL

Specifies the page number at which to start printing a SPOOLed file. This is analogous to the first argument to the /PAGE qualifier on the DCL PRINT command.

By default, the spooler starts printing at the beginning of a file.

[NO]FLAG Applies to: SPL

Enables or disables printing a flag page before a SPOOLed file.

By default, the queue controls whether to print a flag page.

FORM=intexpr Applies to: SPL

FORM=intexpr Applies to: Sequential Files when used with SPOOL

Specifies a predefined form number to use while printing a SPOOLed file.

The VMS system manager sets up queue FORMs. VMS gives FORMs both names and numbers. However, the FORM deviceparameter only accepts numeric identifications.

By default, the spooler prints files on the default form.

GROUP=expr Applies to: SD

Specifies UIC-based security on RMS files. The expression is a mask evaluating to null or to any combination of the letters REWD, indicating respectively READ, EXECUTE, WRITE, and DELETE access. When any one of these deviceparameters appears on a CLOSE, any user category (OWNER, SYSTEM, WORLD), that is not explicitly specified remains unchanged.

In order to modify file security, the user who issues the CLOSE must have control access.

By default, CLOSE does not modify the UIC-based security on an existing file.

[NO]HEADER Applies to: SPL

Enables or disables printing a VMS header on the top of each page of a SPOOLed file. This header includes the file specification and the time and date. When using this header, ensure that the form size is 2 lines larger than the page size of material in the file. Otherwise, printing intended for a single page may overflow onto 2 pages.

By default, the spooler does not print a VMS header.

[NO]HOLD Applies to: S/S

Enables or disables holding the SPOOLed or SUBMITted job for release by an operator.

By default, The VMS job controller starts processing the SUBMITted or SPOOLed file as soon as system resources permit.

LASTPAGE=intexpr Applies to: SPL

Specifies the page number at which to stop printing a SPOOLed file. This is analogous to the second argument to the /PAGE qualifier on the DCL PRINT command.

By default, the spooler stops printing at the end-of-file.

LOGFILE=expr Applies to: SUB

Specifies the file into which a SUBMITted job should log its output. The expression supplies an RMS file specification. This is analogous to the /LOG_FILE qualifier on the DCL SUBMIT command.

By default, the VMS job controller logs a job into the login directory of the account under which the job runs, with a file name constructed from the job name and a file type of .LOG.

LOGQUEUE=expr Applies to: SUB

Specifies the queue used to print the log file of a SUBMITted job. The expression supplies a queue name.

By default, the VMS job controller uses the SYS$PRINT queue.

[NO]LOWERCASE Applies to: SPL

Specifies whether a SPOOLed file prints on a queue supporting a device that can print lower-case characters.

By default, CLOSE does not restrict printing based on this capability.

NAME=expr Applies to: S/S

Specifies the name of a SPOOLed or SUBMITted job. The expression supplies a name from one to 39 characters in length.

By default, a job takes the name of the SPOOLed or SUBMITted file.

NOTE=expr Applies to: SPL

Specifies a note to print on the flag pages of a SPOOLed job. The expression specifies the text of a note. NOTE performs no function if neither the job nor the queue specify BURST and/or FLAG and/or TRAILER.

By default, the spooler does not print the note on flag pages.

[NO]NOTIFY Applies to: S/S

Specifies whether the process receives notification when a SPOOLed or SUBMITted job completes, in the form of a broadcast mailbox message.

By default, when a job completes, the VMS job controller does not notify the other active processes belonging to the same user as the job.

OPERATOR=expr Applies to: S/S

Pauses the queue and notifies the operator to take action when a SPOOLed or SUBMITted job is ready for execution. The expression contains a message, which the VMS job controller sends to the operator console(s).

By default, The VMS job controller does not require operator action before a SPOOLed job prints or a SUBMITted job runs.

OWNER=expr Applies to: SD

Specifies UIC-based security on RMS files. The expression is a mask evaluating to null or to any combination of the letters REWD, indicating respectively READ, EXECUTE, WRITE, and DELETE access. When any one of these deviceparameters appears on a CLOSE, any user category (GROUP, SYSTEM, WORLD), that is not explicitly specified remains unchanged.

In order to modify file security, the user who issues the CLOSE must have control access.

By default, CLOSE does not modify the UIC-based security on an existing file.

P1=expr to P8=expr Applies to: S/S

Specifies the parameters supplied to a SPOOLed or SUBMITted job. Each expression supplies a parameter value. The CLOSE must specify each parameter with a separate Pn deviceparameter. VMS assigns every parameter value to a DCL symbol of the same (Pn) name in the job. This is analogous to the /PARAMETER qualifier on the DCL PRINT and SUBMIT commands.

By default, P1 to P8 have null values.

Example:

	CLOSE sd:(SUBMIT:P1=p1:P2=5:P3="INIT")
	

This CLOSEs the device, and if the device is an RMS file, SUBMITs it to batch with three parameters that are respectively: the value of the variable p1 , the integer 5 and the string "INIT".

[NO]PAGINATE Applies to: SPL

Instructs the spooler whether to insert appropriate carriage control characters whenever output exceeds the form length. This is analogous to the /[NO]FEED qualifier on the DCL PRINT command.

By default, the spooler adds its own pagination.

[NO]PASSALL Applies to: SPL

Enables or disables spooler suppression of non-graphic character sequences in a SPOOLed file. Non-graphic characters should be PASSALLed when they control printer behavior.

By default, the spooler does not send non-graphic sequences to the printer.

[NO]PRINT Applies to: SUB

Specifies whether to print and delete, or not print and retain, the log file generated by a SUBMITted job. This is analogous to a combination of the /KEEP and /PRINT qualifiers on the DCL SUBMIT command.

By default, the VMS job controller prints and deletes the log file.

PRIORITY=intexpr Applies to: S/S

Specifies the priority of a SPOOLed or SUBMITted job. Attempts to raise priority above a SYSGEN established maximum (MAXQUEPRI) only succeed if the user has appropriate VMS privileges (OPER or ALTPRI).

By default, a SYSGEN parameter (DEFQUEPRI) and the priority of the submitting process control the priority of a SPOOLed or SUBMITted job.

QUEUE=expr Applies to: S/S

Specifies the queue for a SPOOLed or SUBMITted job. The expression supplies a queue name.

By default, SPOOLed jobs go to SYS$PRINT and SUBMITted jobs go to SYS$BATCH.

REMOTE=expr Applies to: S/S

Specifies the node on the network where a SPOOLed or SUBMITted job executes. The expression supplies the node name of the target system. Within a VMSCluster, a shared queue management system may direct SPOOLed or SUBMITted jobs to other members of the cluster without use of the REMOTE parameter.

By default, the VMS job controller executes a job on the system from which it is SPOOLed or SUBMITted. However, by default, in a VMSCluster with a shared queue management system, the VMS job controller executes a job on the cluster member with the largest current supply of required resources.

RENAME=expr Applies to: SD

Changes the file name to the name contained in the argument string. When the expression omits part of the file specification, GT.M constructs the full file specification by applying the defaults discussed in the section on device specifications.

If the process has sufficient access permissions, it may use RENAME to specify a different directory as well as file name, type and version. RENAME cannot move a file to a different device.

[NO]RESTART Applies to: S/S

Enables or disables automatic restart on reboot after a system failure for a SPOOLed or SUBMITted job.

By default, the VMS job controller requires operator intervention to restart jobs running at the time of a system failure.

SETUP=expr Applies to: SPL

Specifies one or more setup modules to copy to the printing device before the contents of a SPOOLed file. The expression supplies a list of setup module names separated by commas (,). VMS stores setup modules in a device control library and the spooler uses them to initialize or download programmable printers.

By default, the spooler sends no setup modules to the printer ahead of a SPOOLed file.

SOCKET=expr Applies to: SOC

The socket specified in expr is closed. Specifying a socket that has not been previously OPENed generates an error. If no SOCKET deviceparameter is specified on a CLOSE for a socket device, the socket device and all sockets associated with it are closed.

SPOOL Applies to: SD

Sends the sequential file to the default print queue SYS$PRINT. The deviceparameter QUEUE provides a means to specify different print queues.

SUBMIT Applies to: SD

Submits the named sequential file to the default batch queue SYS$BATCH. The deviceparameter QUEUE provides a means to specify different print queues.

Specifies UIC-based security on RMS files. The expression is a mask evaluating to null or to any combination of the letters REWD, indicating respectively READ, EXECUTE, WRITE, and DELETE access. When any one of these deviceparameters appears on a CLOSE, any user category that is not explicitly specified remains unchanged.

SYSTEM=expr Applies to: SD

Specifies UIC-based security on RMS files. The expression is a mask evaluating to null or to any combination of the letters REWD, indicating respectively READ, EXECUTE, WRITE, and DELETE access. When any one of these deviceparameters appears on an OPEN of a new file, any user category that is not explicitly specified is given the default mask. When any one of these deviceparameters appears on an OPEN of an existing file, any user category (OWNER, GROUP, WORLD), that is not explicitly specified remains unchanged.

In order to modify file security, the user who issues the OPEN or CLOSE must have control access ownership.

By default, CLOSE does not modify the UIC-based security on an existing file.

[NO]TRAILER Applies to: SPL

Enables and disables printing a flag page after a SPOOLed file.

By default, the queue controls printing of trailing flag pages.

USER=expr Applies to: S/S

Specifies the user name under which a SPOOLed or SUBMITted job runs. The expression supplies a currently valid one to 12 character user name. USER requires the VMS CMKRNL privilege.

By default, the VMS job controller runs the job under the account of the process by which it was SPOOLed or SUBMITted.

WORLD=expr Applies to: SD

Specifies UIC-based security on RMS files. The expression is a mask evaluating to null or to any combination of the letters REWD, indicating respectively READ, EXECUTE, WRITE, and DELETE access. When any one of these deviceparameters appears on a CLOSE, any user category (OWNER, GROUP, SYSTEM), that is not explicitly specified remains unchanged.

In order to modify file security, the user who issues the CLOSE must have control access.

By default, CLOSE and CLOSE do not modify the UIC-based security on an existing file. Unless otherwise specified, when CLOSE creates a new file, it establishes security using standard defaulting rules.

In order to modify file security, the user who issues the CLOSE must have control access.

By default, CLOSE does not modify the UIC-based security on an existing file.