This command changes the CPS Writer characteristics from those originally set with a CPS WRITER initialization statement. Use of this command requires an active CPS SPOOL File.
Scope—SPOOLplex
Duration—Permanent effect, if a CPS SPOOL file is used. Otherwise, changes will be overridden at the next TMSS restart.
The CPS WRITER| CPS W syntax is as follows:
| [? | HELP] name [BOTTOMMARGIN(nnn)] [CONSOLE(ucm | console-name) | ROUTE(nnn)] [DESTINATION(dest1 dest2 ...) | ADESTINATION(dest1 dest2 ...) | RDESTINATION(dest1 dest2 ...)] [PACE(factor)] [PAGELENGTH(nnn)] [START | DRAIN] [TOPMARGIN(nnn)] |
| |
|---|
| Requests the command syntax from HELP. |
| Is a unique name for this CPS Writer. Its length must be 1 to 8 alphabetic, numeric, or national characters. This parameter is positional and must be specified. It must identify one of the CPS Writers defined during BMC ThruPut Manager initialization. - BOTTOMMARGIN(nnn)—Specifies the number of blank lines inserted at the bottom of output produced by this CPS Writer. The short form for this keyword is BM.
- nnn — Must be a valid integer in the range 0 to 255.
- CONSOLE(ucm | console-name)—Specifies the console number or name that this Writer uses to print output. The console must be defined to z/OS, but does not have to be online. This keyword is mutually exclusive with the ROUTE keyword.
- ucm— A console identifier. If '0' is specified, output is printed using an route code instead of a console number.
- console-name—Specifies the console name that identifies the console.
- ROUTE(nnn) —Specifies the route code used for output printed by this Writer. This keyword is only effective if there is no console number or console name in effect for this CPS Writer. This keyword is mutually exclusive with the CONSOLE keyword.
- nnn—A 1 to 3 digit route code.
- DESTINATION(dest1 dest2 ...)—Can be a null string, or can specify one or more CPS Destinations that this CPS Writer will select. If the value is a null string, this CPS Writer does not print any output until another operator command changes its selection criteria. This keyword is mutually exclusive with the ADESTINATION and RDESTINATION keywords. The short form for this keyword is DEST.
- (dest1 dest2 ...)—A list of destination names.
- ADESTINATION(dest1 dest2 ...) —Specifies one or more CPS Destinations that are added to this CPS Writer. This keyword is mutually exclusive with DESTINATION and RDESTINATION. The short form for this keyword is ADEST.
- (dest1 dest2 ...)—A list of destination names.
- RDESTINATION(dest1 dest2 ...)—Specifies one or more CPS Destinations that are removed from this CPS Writer. This keyword is mutually exclusive with DESTINATION and ADESTINATION. The short form for this keyword is RDEST.
- (dest1 dest2 ...)—A list of destination names.
- PACE(factor)—Specifies the "pacing factor" for this Writer. This is the approximate number of milliseconds per line of output that should elapse between the time printing of a line of output begins and the time the next line is selected for this Writer. Pacing protects against a sudden influx of output depleting the WQEs.
- factor—This operand must be an integer in the range 0 to 30000, specifying the pacing factor in milliseconds. If the CPS SPOOL File is not used, this operand is ignored.
- PAGELENGTH(nnn)—Specifies the page length (in terms of number of lines) of output printed by this CPS Writer. The short form for this keyword is PL.
- nnn—The value must be an integer in the range 0 to 255. If it is specified as 0, no pagination is performed. When PAGELENGTH is not zero, the CPS Writer inserts blank lines at the end of the output to ensure that the number of lines printed is a multiple of the PAGELENGTH value.
- START —Causes the CPS Writer to become active.
- DRAIN—Causes the CPS Writer to cease activity.
- TOPMARGIN(nnn)—Specifies the number of blank lines inserted at the top of output. The short form for this keyword is TM.
- nnn—Must be an integer in the range 0 to 255. The default value is 0.
|
WarningImportant
- This command can be used to change the parameters of a CPS Writer belonging to another TMSS, provided they are sharing the CPS SPOOL File. The changes take effect the next time the CPS Writer selects work from the CPS SPOOL.
- If the CPS SPOOL File is in use, changes made to a CPS Writer are effective across TMSS starts, and override the BMC ThruPut Manager initialization parameters until a CPS SPOOL COLD start is done.