HP e3000 MPE/iX Release 6.0 System Software Maintenance Manual (30216-90272)

Appendix G 289
HP Stage/iX Reference
HP Stage/iX Commands
CREATE (CR)
The CREATE command will create an empty HP Stage/iX staging area. At the time the
staging area is created, you are allowed to specify a brief description for the staging area.
Staging areas are normally created by HP Patch/iX. A default description is associated
with the staging area at that time, but you can change that description using the CHANGE
command.
When a staging area is initially created, it will be considered “invalid”. It will remain
invalid until it is validated by the VALIDATE command.
You must specify a name for the staging area to be created. The staging area name must be
a valid HP Stage/iX staging area name (see below), and cannot be the name of a staging
area that already exists. The name “BASE” is reserved by HP Stage/iX to refer to the Base
system software environment (see the SET command). You are not allowed to create a
staging area named “BASE.” This includes all forms of the word BASE, Base, or base.
HP Stage/iX staging areas are created as sub-directories under the HP Stage/iX root
directory. The HP Stage/iX root directory is /SYS/hpstage/. The staging area “stage_1”
for example would be kept in the MPE directory /SYS/hpstage/stage_1/.
The CREATE command can be abbreviated CR.
Syntax
CREATE [STAGE=] stage_name [[;DESC=] quoted_string ]
Parameters
[STAGE=]stage_name (required)
This parameter specifies the name to be given to the newly created staging area. The
staging area name can be up 16 characters in length. The staging area name must be a
valid MPE/iX directory name. For this reason, the staging area name cannot contain a “/”
character. It may contain letters (upper or lower case), numbers, and the special characters
“_”, “-”, and “.”.
Staging area names are case sensitive. “STAGE1” is not equivalent to “stage1” or “Stage1”.
[;DESC=]quoted_string (optional)
This parameter must be a quoted string if it contains any delimiter characters (like blanks,
commas, semi-colons, or any other punctuation characters). The description can be any
string up to 128 characters in length.
Example
To create a new staging area called “new_stage” with the description “misc. patches”:
STAGEMAN> CREATE NEW_STAGE;DESC="MISC.PATCHES"
DELETE (DEL)
The DELETE command will delete an HP Stage/iX staging area and its contents. If the
system is currently booted from an HP Stage/iX staging area, then that staging area
cannot be deleted. In addition, if a staging area has been designated for the next boot (see