This section tells you how to define, maintain, and report on PAC statuses. For general information about statuses, see Configuring a PAC Environment.
A status must be defined to PAC before it can be linked to an application. An environment exists only when statuses are linked with applications.
Access the PAC Status maintenance and reporting sub-functions by entering code S (Statuses) on the PAC Main Menu.
The screen that appears depends on your user profile. The Status Menu shown below combines the maintenance and reporting sub-functions and is used in discussions throughout this section.
08:18:55 ***** PREDICT APPLICATION CONTROL ***** 2000-04-19
User PACUSR - Status Menu - Code Sub-Function
Code Sub-Function
---- ---------------------------- ---- ----------------------------------
A Add a Status Definition S Select Status from a List
D Display Status Definition T Applications linked to a Status
L Link Status to Applications U Statuses with no Application Links
M Modify Status Definition ? Help
P Purge Status Definition . Exit
---- ----------------------------- ---- ----------------------------------
Code ..... _
Status ... ________________________________
Keyword .. ________________________________
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit Canc
|
| Field | Description | |
|---|---|---|
|
|
||
| Status | Specifies a new or existing PAC status. You may enter a status name, an alias, or range notation. The status name must begin with an alphabetic character and may be up to 32 characters in length. Embedded blanks are allowed, but are automatically translated to the underscore ( ) character. If a duplicate status name is entered, an error message is displayed. | |
| Keyword | The name of a keyword that has been assigned to the status with the "Keys" Additional Options function. | |
Note:
All of the sub-functions on this menu, except Add, may be selected for
processing directly from the Status Selection List that is accessed using the
Select Status from a List sub-function.
This document covers the following topics:
Access the Add Status screen by entering Code A (Add a Status Definition) and a unique status name on the Status Menu. Alternatively, enter the ADD direct command on the command line. Refer to the PAC Reference documentation for the correct syntax.
18:02:22 ***** PREDICT APPLICATION CONTROL ***** 2000-04-21
User PACUSR - Add Status -
Status ....... NEW Modified: 1998-04-21 by PACUSR
Keys ......... ,,,,,,,,,,,,,,,,,,,
Status Type ..... ____________
Notes ........... _______________________________________________________
_______________________________________________________
_______________________________________________________
PREDICT File ......... DBnr.. ___ Fnr.. ___ Maintain Xref .. N
NATURAL File ......... DBnr.. ___ Fnr.. ___
Production PAA File .. DBnr.. ___ Fnr.. ___
Additional Options .. N
Command ===>
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit Opts Canc
|
Note:
Edit all values on the screen before you access the Additional
Options. Once the Additional Options are accessed, all other fields on the
screen are protected. Values may be modified later with the Modify Status
sub-function.
In the Status Type field, enter a valid status type by typing a valid one-character code or the entire name over the first character of "Unknown".
For details on the possible status types please refer to the descriptions given in the section Status Types.
Note:
Archive, Control and Retire statuses may not be assigned. Only PAC
designates Archive, Control and Retire status types.
(Optional) In the Notes field, enter comments.
In the Predict Data and Natural File fields, enter the database number (DBnr) and file number (Fnr) of the Predict data and Natural files that will be associated with the new status.
For the Production PAA File field, specify the DBID and file number of the PAA file that will be active for the application objects transferred to this production status.
In the Maintain Xref field, identify the way you want cross-reference data to be maintained by entering one of the following options. The option depends on the status.
Access Additional Options by pressing PF4 (Opts), or by typing Y (Yes) over the default.
From the resulting window, select and edit any of the following options that you wish to specify:
| Option | Description | |
|---|---|---|
|
|
||
| Aliases | Add alias names for the status. | |
| Keys | Add keywords for the status. Keywords must have been previously defined to PAC. | |
| Linked Applications | Add the names of applications you want to link to the status. Refer to the section , Linking Applications and Statuses, on page for more information. | |
The Date option displays information about the dates and times the status was added/modified and by whom.
Press ENTER to return to the Add Status screen when you have finished editing the options.
Add the new status to PAC by pressing ENTER on the Add Status screen.
When you have added the new status, you are returned to the Status Menu where the message "Status has been added successfully." is displayed.
You may display or modify information about a status on the Display Status and Modify Status screens, respectively. Maintenance may not be performed on the Display Status screen. The section Add (Define) a Status provides a similar screen for reference.
To access the Display Status or Modify Status screens from the Status Menu, enter Code D (Display Status) or M (Modify Status) and the name of the desired status. Alternatively, enter the DISPLAY or MODIFY direct commands on the command line of the relevant menus. Refer to the PAC Reference documentation for the correct syntax.
To select a status, access the Status Selection List by entering Code S (Select Status from a List) on the Status Menu. Alternatively, enter the SELECT STATUS direct command on the command line of the Application Menu. Refer to the PAC Reference documentation for the correct direct command syntax.
If you accessed the Status Selection List screen with the S (Select Status from a List) sub-function or with the SELECT STATUS direct command for one or more of the listed statuses, you may perform the following sub-functions directly by entering the function code in the "C" column:
| Code | Sub-Function | |
|---|---|---|
|
|
||
| D | Display a status definition | |
| L | Link applications to a status | |
| M | Modify a status definition | |
| P | Purge a status definition | |
| S | Select a status definition | |
| T | Applications linked to a status | |
| U | Statuses without application links | |
| . | (Quit/return to the main menu) | |
If you mark the status with the cursor or enter an S or a T in the "C" column or if you enter the status number (from the "Nr" column) in the Mark Selection... field, the Status Menu appears with the specified status already displayed in the Status field.
You may link several applications to a specified status with the Link Applications to a Status sub-function.
From the Status Menu, access the Link Applications to a Status screen by entering Code L (Link Applications to a Status) and by either entering the desired status name or by selecting it from the resulting status list.
08:38:57 ***** PREDICT APPLICATION CONTROL ***** 2000-04-19
User PACUSR - Link Applications to a Status -
Status ... DEVELOPMENT (Development)
Library Predict
C Linked Application Name DBnr Fnr DBnr Fnr Xr Message
--- -------------------------------- ---------------- ----------- ----------
__ NATURAL_SECURITY________________ SYSSEC__ 235 _18 235 _10 N
__ ORDERS _________________________ ORD-EXAM 235 __9 235 _10 N
__ PREDICT_________________________ PREDICT_ 235 _18 235 _44 N
________________________________ ________ ___ ___ ___ ___ _
________________________________ ________ ___ ___ ___ ___ _
________________________________ ________ ___ ___ ___ ___ _
________________________________ ________ ___ ___ ___ ___ _
________________________________ ________ ___ ___ ___ ___ _
________________________________ ________ ___ ___ ___ ___ _
________________________________ ________ ___ ___ ___ ___ _
________________________________ ________ ___ ___ ___ ___ _
________________________________ ________ ___ ___ ___ ___ _
Enter options (above), or '?' (help), or '.' (exit): _
Enter-PF1---PF2---PF3---PF4---PF5---PF6---PF7---PF8---PF9---PF10--PF11--PF12---
Help Menu Exit Canc
|
This screen displays existing application status links as well as library and Predict information for the applications.
Enter the following information on the blank lines:
In the Linked Application column, the application(s) to be linked to the specified status;
In the Library columns, the library, database number, and file number where the application status is located.
Note:
The library locations used for the Control status, as well as for
the Archive (A), Retire (R), Production (P) and Neighbour (N) statuses, are
reserved for use by PAC.
In the Predict columns, enter the Predict database ID number and file number where the cross-reference data is stored.
Note:
If you do not enter a Predict database and file number, the
Predict Data database (DBnr) and file number (Fnr) display the values set when
the application was defined. You may override these values.
In the Predict "Xr" column, enter the following cross-reference information: L (Local), R (Remote), B (Both), or N (None). Refer to the explanation in Step 2 "Editing the Add Status Screen" for more information. Available options depend on the status type.
The Message column displays messages relevant to sub-functions performed on the listed application status.
Refer to the section Linking Applications and Statuses for detailed information about linking applications to a status.
This section covers the following topics:
You may select additional sub-functions for linked applications without returning to a menu.
In the "C" column on the Link Applications to a Status screen, mark the desired application with the appropriate two-character code to display the desired option screen.
The following sub-functions are available:
| Code | Sub-Function | |
|---|---|---|
|
|
||
| DI | Display Link Definition | |
| AP | Display Application Definition | |
| ST | Display Status Definition | |
| MO | Modify Link Definition | |
| PU | Purge Link Definition | |
To access a list of available options for a PAC object, mark the desired object with a ? or an asterisk (*) in the "C" column at the left of the screen.
The resulting Options window lists the available sub-functions and their corresponding codes.
In the Options window, select the sub-function by entering the relevant code on the command line.
You can display the existing application status links for a specific status on the Applications Linked to a Status screen by entering Code T (Statuses Linked to Application) and the status name. Maintenance may not be performed from this screen.
This screen is similar to the Link Applications to a Status screen described.
You can display a list of statuses not linked to applications by entering Code U (Statuses with No Application Links) on the Status Menu.
Note:
A status may be purged under certain circumstances, but a status type
cannot be modified.
To purge a status, enter Code P and the status name on the Status Menu. Alternatively, enter the PURGE direct command on the command line. Refer to the PAC Reference documentation for the correct syntax.
If versioned objects exist in the status under PAC control, the purge request is ignored and the following message is displayed:
"Objects exist for this status. Purge cannot be performed until the objects have been deleted using the PAC Administrator Functions."
Otherwise, the Purge Confirmation window appears reminding you that the associated application status links, migration paths, and fixed file translation tables will also be purged.
To purge the status, type CONFIRM or press PF5.
To return to the Status Menu without purging the status, type a period (.) or press PF3.