Previous Topic Next topic Print topic

Micro Focus Server Enterprise Edition for UNIX > Mainframe Support for Deployed Applications > Reference for MSS Deployment > JCL Commands > casout
Micro Focus Server Enterprise Edition for UNIX > Enterprise Server > Reference for MSS Deployment > JCL Commands > casout

casout

Starts a batch service execution process or administers a batch job.

Syntax:

casout [/res-name]
       [/sprototype:host:port]
       [/lservername]
       [/gnumber]
       [/gnumber:reldd]
       [/doutput-dsn]
       [/iclasses]
       [/jjobnumber:step:procstep]
       [/knumber]
       [/mnumber]
       [/fnumber]
       [/uuserid]
       [/ppassword]

Parameters:

Connection parameters
/res-name Connect to the named enterprise server. Defaults to ESDEMO.
Note:

When calling this utility from JCL or from a WEB service (that is, when you are running the utility within a SEP) you cannot use the /r option to connect to the server. Where this is the case, you must use the /s or /l options to connect to the server.

or:  
/sprototype:host:port Use the specified URL to find the enterprise server to connect to, for example stcp:localhost:9003
or:  
/lservername Look up the specified servername to find the enterprise server to connect to.
Other parameters
/gnumber Display all sysout for job number number.
or:  
/gnumber:reldd Retrieve the relative dd for job number number.
/doutput-dsn Output DSN for sysout retrieval. The-d option must precede the -g option.
/iclasses Start an initiator to run jobs of the named classes.
/jjobnumber:step:procstep Restart the job at the specified step/procstep. The procstep is optional.
/knumber Kill job number number.
/mnumber:class Modify job number number to use the specified class.
/fnumber Flush the output of job number number.
/uuserid Authorization user ID.
/ppassword Authorization password.
/cgroup The sign-on group to be used when running commands.
/qmessage-classes Start an IMS Message Processing Region for the specified classes.
/tprocess-ID Terminate the batch initiator, batch printer or IMS MPR that has the specified process ID.
/v List all batch initiators, batch printers and IMS MPRs.
/nprinter-name Specifies the name of the physical device to be used by a new batch printer. This option is used with the /b and /x options.
/boutput-classes Specifies the output classes to be handled by a new batch printer. This option is used with the /n and /x options.
/xprinter-exit Specifies the name of the name of a printer exit to be associated with a new batch printer. Used with the /n and /b options.

Dependencies:

  • You must have started the enterprise server before you can issue a casout command.
  • In order to successfully run the casout command, you must have execute permissions on the casout resource within the OPERCMDS resource class.

Comments:

The /r, /s and /l options are alternatives and are mutually exclusive.

On UNIX you can use a dash (-) before a parameter as an alternative to a forward slash (/).

Examples:

Starting an initiator for classes EFG on Enterprise Server JCLT: 

casout /rJCLT /iEFG

Start a batch printer using the physical device "TestPrinter" for classes EFG on Enterprise Server JCLT: 

casout /rJCLT /bEFG /n"TestPrinter"

Start a batch printer as in the previous example, but this time associate it with a printer exit (sampprnx): 

casout /rJCLT /bEFG /n"TestPrinter" /xsampprnx

Start an IMS Message Processing Region for specified message classes: 

casout /rJCLTT /q001
Parent topic: JCL Commands
Previous Topic Next topic Print topic