Pathway/iTS SCUP Reference Manual

SCUP Commands
HP NonStop Pathway/iTS SCUP Reference Manual—520269-002
2-7
ALTER Command
(program-name)
is a SCREEN COBOL program name. The program name can be a single
program name or several program names separated by commas.
(*)
is all program names in the object file.
If program-name or * is omitted, the ALTER command changes the access
setting for the library in the object file control record. This setting determines the
access of all programs subsequently added to the object file.
(version)
is the version of the specified program name. Version can be any of the
following:
If the version parameter is omitted, the latest version of a program is used.
ACCESS { ON }
{ OFF }
specifies the access setting (ON or OFF) of either the object file or programs in the
object file.
If ACCESS is set OFF for the object file, any program subsequently added to the
object file has access set OFF.
If ACCESS is set ON for the object file, any program subsequently added to the
object file has access set ON.
If ACCESS is set OFF for any program, the program becomes inaccessible for
execution under the PATHWAY system; the program is not again made accessible
until ACCESS is set ON.
When executing an ALTER command, SCUP allows shared access to the SCREEN
COBOL object file. From the moment the ALTER command completes, any attempt to
find the specified programs (either through a CALL statement in a SCREEN COBOL
program or through the INITIAL setting when starting a terminal) fails. Any terminal
already executing that program continues unaffected. Thus, the program can still be in
use, but no new references can be made to it.
The expansion of the object file name uses the default settings specified by the
CMDSYS and CMDVOL basic commands.
integer a single version of a program
* all versions of a program
+ all but the latest version of a program