HP 3000 Manuals HP 3000 Manuals
MODIFY
Modifies the information for an entity which was created with the CREATE
command.
Syntax
[option] MODIFY subcommand
M
Use the MODIFY command to change the attributes and/or the description of
an entity created with the CREATE command. The edit description can also
be modified with the prompt EDIT COMMAND. Refer to Using Edit Description
Commands in Section III for a complete list of EDIT COMMANDs.
The subcommand identifies the type of entity to be modified. For
example, MODIFY CATEGORY, allows you to enter a new type designator,
change the name of the person responsible, or enter a new textual name
for the category. It also allows you to edit the textual description for
the category. A complete list of entities that can be modified is given
below under Subcommands.
Subcommands
Any of the following subcommands can be used with the MODIFY command:
CATEGORY modifies a category
CLASS modifies a security class
ELEMENT modifies a data element
FILE modifies a file
GROUP modifies an HP Inform group
LOCATION modifies a physical location
PROCEDURE modifies a procedure
Example
>MODIFY CATEGORY
CATEGORY> Marketing < Category to be modified.
EDIT DESCRIPTION(Y/N)? n No, to edit description.
CATEGORY: TYPE: RESPONSIBILITY:
Marketing SPLS John Williams
LONG NAME:
TYPE> Attribute prompt.
RESPONSIBILITY> James Max Changed name.
LONG NAME> Marketing Supplies Sales Added information.
> New command prompt.
Subcommand Prompts
For the prompts shown with an asterisk (*), you must enter a response
other than [[RETURN]] in order to implement the command string.
You enter: You are prompted for:
COMMAND SUBCOMMAND PROMPT
MODIFY CATEGORY * CATEGORY
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
TYPE
RESPONSIBILITY
LONG NAME
MODIFY CLASS * CLASS
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
TYPE Issued only if CLASS type is
not INFO or if CLASS type is
INFO but the file is not
associated or related to any
other entity.
PASSWORD
RESPONSIBILITY
LONG NAME
RESTRICTED FILE Issued only if CLASS type is
not INFO.
MODIFY ELEMENT * ELEMENT
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
TYPE
SIGN POSITION Issued only if TYPE Z.
ELEMENT REFERENCE Issued only if TYPE is "*".
SIZE Issued if TYPE is not "*"
or B.
DECIMAL Issued if TYPE is numeric.
STORAGE LENGTH(n) Issued if TYPE is not "*", B
or S.
COUNT
RESPONSIBILITY
LONG NAME
HEADING TEXT
ENTRY TEXT
EDIT MASK
MEASUREMENT UNITS
BLANK WHEN ZERO(N/Y) Issued if TYPE is Z or 9.
RIGHT JUSTIFY(N/Y)? Issued if TYPE is X or U.
SYNCHRONIZED(N/Y)? Issued if TYPE is I, J, or K.
MODIFY FILE * FILE
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
TYPE Issued only if the file has
not been associated or
related to any other entity.
RESPONSIBILITY
LONG NAME
RECORD FORMAT(F/V/U/S)? Issued only if file type
is KSAM, MPEF, or MPER.
MINIMUM RECORD SIZE Issued only if TYPE is KSAM,
MPEF or MPER and RECORD
FORMAT is V or U.
MAXIMUM RECORD SIZE Issued only if file type is
KSAM, MPEF or MPER.
MODIFY BLOCKING(N/Y)? Issued only if TYPE is KSAM,
MPEF or MPER.
UNIT(R/C)? Issued if YES to BLOCKING.
BLOCK MINIMUM Issued if YES to BLOCKING.
BLOCK MAXIMUM Issued if YES to BLOCKING.
RECORDING MODE(A/B)? Issued only if file type is
MPEF or MPER.
DATA STORAGE TYPE(A/E)? Issued only if file type
is MPEF.
CCTL(N/Y)? Issued only if file type is
MPEF.
DEVICE Issued only if file type is
MPEF.
DEVICE CLASS(DA/UR/UT)? Issued only if file type is
MPEF.
MODIFY GROUP * GROUP
EDIT DESCRIPTION(Y/N)?
* EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to
DESCRIPTION.
TYPE
RESPONSIBILITY
LONG NAME
MODIFY LOCATION * LOCATION
EDIT DESCRIPTION(Y/N)?
EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
GROUP
ACCOUNT
CPU
LONG NAME
MODIFY PROCEDURE * PROCEDURE
EDIT DESCRIPTION(Y/N)?
EDIT COMMAND>> Issued only if Yes to EDIT
DESCRIPTION.
EDIT ATTRIBUTES(Y/N)? Issued only if Yes to EDIT
DESCRIPTION.
TYPE
LANGUAGE
RESPONSIBILITY
LONG NAME
Prompts
Depending on the subcommand used, one or more of the following prompts is
issued:
ACCOUNT Enter a new name for the MPE account that is
associated with the location (8 characters
maximum).
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
BLANK WHEN ZERO(N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter Y if the element is
to be displayed as a blank when its value is
equal to 0. DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
CATEGORY Enter the name of an existing category (20
characters maximum).
CCTL(N/Y) This prompt generates data that will be used by
the DICTCDE utility. Enter Y if the carriage
control option for an output file is to be
specified. DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates that no
change is to be made.
CLASS Enter the identifying number of an existing
security class (0 to 9999).
COUNT Enter a positive integer value for a new
sub-element count if the data element is a
compound type (1 to 9999). DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
CPU Enter the new name of the machine that is
associated with the location (8 characters
maximum). DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
DATA STORAGE TYPE (A/E)? This prompt generates data that will be used by
the DICTCDE utility. Enter one of the
following to change the character code that
represents how data is stored in the file:
A ASCII character codes
E EBCDIC character codes
DEFAULT: pressing [[RETURN]] indicates no
change .
DECIMAL Enter a new integer value for the number of
digits to the right of the decimal point (0 to
9999). Do not include a position for the
decimal point itself. The largest value for
each element type is as follows:
For types Z, P, and 9, the largest value is 27
decimal digits.
For types I, J, and K, the largest value is 28
decimal digits.
For types E and R, the largest value is 9999
decimal digits.
Note that if the maximum value for SIZE is
entered, a decimal value is required. DEFAULT:
Pressing [[RETURN]] in response to this prompt
indicates no change.
DEVICE This prompt generates data that will be used by
the DICTCDE utility. Enter the type of user
specified device on which the file resides (8
characters maximum). DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
that no change is to be made.
DEVICE CLASS (DA/UR/UT)? This prompt generates data that will be used by
the DICTCDE utility. Enter the class of device
on which the file resides as follows:
DA mass storage device
UT utility device (such as a tape drive)
UR unit record device (such as a card
reader)
DEFAULT: Pressing [[RETURN]] indicates no
change is to be made.
EDIT ATTRIBUTES(Y/N)? Enter an N if attribute prompts are not to be
issued.
EDIT COMMAND>> Enter one of the EDIT COMMANDS described under
Using Edit Description Commands in Section III.
EDIT DESCRIPTION(Y/N)? Enter an N if description text editing is not
required.
EDIT MASK Enter a new textual edit mask to be used to
edit values when displayed for the data element
(30 characters). This is used by HP Inform,
Report, and Transact. (Refer to Using Edit
Masks in Section III.) DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
ELEMENT Enter the name of an existing data element (20
characters maximum).
ELEMENT REFERENCE This prompt generates data that will be used by
the DICTPDE utility. Enter the name of an
existing element that is being back-referenced.
The element being modified will have the same
type, size, storage length, sub-element count
and decimal position of the ELEMENT REFERENCE.
DEFAULT: Pressing [[RETURN]] in response to
this prompts indicates the ELEMENT REFERENCE
does not change.
ENTRY TEXT Enter new textual information to be used by HP
Inform, Report, and Transact as a prompt for
input. This text replaces the primary name in
the prompt (30 characters maximum). DEFAULT:
Pressing [[RETURN]] in response to this prompt
indicates no change.
FILE Enter the name of an existing file (20
characters maximum).
GROUP If the subcommand is:
GROUP enter the name of an existing HP
Inform group (20 characters
maximum). NOTE: $MENU can not be
modified.
LOCATION enter the name of a new MPE group
to be associated with the
location (8 characters maximum).
DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates
no change.
HEADING TEXT Enter a new textual heading to be used by HP
Inform, Report, and Transact for the heading in
reports. This heading replaces the data
element's primary name in reports (30
characters maximum). DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
LANGUAGE Enter the name of a new implementation language
for the procedure (10 characters maximum).
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
LOCATION Enter the name of an existing physical location
(20 characters maximum).
LONG NAME Enter a new, full textual name for the entity
(50 characters maximum). DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
MAXIMUM BLOCKING This prompt generates data that will be used by
the DICTCDE utility. Enter the maximum
blocking factor for the file. DEFAULT:
Pressing [[RETURN]] in response to this prompt
indicates no change.
MAXIMUM RECORD SIZE This prompt generates data that will be used by
the DICTCDE utility. Enter the maximum number
of characters in the record. DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
MEASUREMENT UNITS Enter a new type of measurement units (such as
feet, dollars) for the data element's value (10
characters maximum). DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
MINIMUM BLOCKING This prompt generates data that will be used by
the DICTCDE utility. Enter the minimum
blocking factor for the file. DEFAULT:
Pressing [[RETURN]] in response to this prompt
indicates no change.
MINIMUM RECORD SIZE This prompt generates data that will be used by
the DICTCDE utility. Enter the minimum number
of characters in the record. DEFAULT: Pressing
[[RETURN]] indicates no change.
MODIFY BLOCKING (N/Y)? This prompt generates additional prompts to
modify the blocking factor of the file. Those
prompts generate data that can be used by the
DICTCDE utility. DEFAULT is No.
PASSWORD Enter a new password for the user security
class (8 characters maximum). A blank value
(pressing the space bar followed by [[RETURN]])
removes the password. DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
PROCEDURE Enter the name of an existing procedure (20
characters maximum).
RECORD FORMAT (F/V/U/S) This prompt generates data that will be used by
the DICTCDE utility for COBOL II programs.
Enter one of the following to specify how the
logical records are contained in the file:
F for fixed length logical records
V for variable length logical records
U for undefined length logical records
S for the multirecord or "multiblock"
option
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
RECORDING MODE(A/B)? This prompt generates data that will be used by
the DICTCDE utility. Enter A to change the
recording mode of the file to ASCII. Enter B to
change the recording mode of the file to
BINARY. DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
RESPONSIBILITY Enter a new name for the person, department, or
area responsible for the integrity of the
entity (20 characters maximum). DEFAULT:
Pressing [[RETURN]] in response to this prompt
indicates no change.
RESTRICTED FILE If the scope of the security class is to be
limited to a file, enter the name of the file
(20 characters maximum). The file type must be
BASE. DEFAULT: Pressing [[RETURN]] in response
to this prompt indicates no change.
RIGHT JUSTIFY(N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter Y or Yes to right
justify alphabetic or alphanumeric data
elements. DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
SIGN POSITION This prompt generates data that will be used by
the DICTCDE utility. Enter the position of the
sign for a signed numeric data element as
follows:
LO leading overpunched
LS leading separate
TO trailing overpunched
TS trailing separate
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
SIZE Enter a new integer value required to display
an element (1 to 9999). Include a position for
a decimal point if there is one, but do not
include one for a sign. The largest value for
each type is as follows:
For types Z, P, and 9, the largest value is 28
digits.
For types I, J, and K, the largest value is 29
digits.
For types E, R, X, and U, the largest value is
9999 digits.
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
STORAGE LENGTH(n) The calculated storage length in bytes is
displayed as "n" . An over-ride value may be
entered (1 to 9999). DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
SYNCHRONIZED(N/Y)? This prompt generates data that will be used by
the DICTCDE utility. Enter Y or Yes to align
the data elements in order to facilitate
arithmetic operations. DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.
TYPE If the subcommand is:
CATEGORY, CLASS, GROUP, or PROCEDURE enter a
new user defined type (4 characters maximum).
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
ELEMENT enter a new type for the data element
as follows: :
U upper case ASCII
X upper or lower case ASCII
9 numeric ASCII
Z zoned decimal
P packed decimal
I integer binary
J integer binary (COBOL)
K logical
R floating point (commercial)
E floating point (E format)
S string (PASCAL)
B boolean (PASCAL)
* back reference to an existing element
(PASCAL)
If the type used is numeric, a plus character
(+) following it indicates that the data
element may have only positive values. If a
plus character is used with any other type, it
is ignored. DEFAULT: Pressing [[RETURN]] in
response to this prompt indicates no change.
FILE - enter a new file type based on one of
the following types:
BASE IMAGE database name
MAST IMAGE manual master data set
AUTO IMAGE automatic master data set
DETL IMAGE detail data set
FORM VPLUS form
VLPS VPLUS forms file name
MPEF MPE sequential file
MPER MPE relative file
KSAM KSAM file
DEFAULT: Pressing [[RETURN]] in response to
this prompt indicates no change.
UNIT(R/C)? This prompt generates data that will be used by
the DICTCDE utility. Specify the unit used to
determine the blocking factor with R for
RECORDS or C for CHARACTERS. DEFAULT: Pressing
[[RETURN]] in response to this prompt indicates
no change.