Statuses

#### Search Results

Search

# Statuses

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:

- Adding (Defining) a Status

- Displaying/Modifying a Status

- Selecting a Status

- Linking Applications to a Status

- Purging a Status

## Adding (Defining) a Status

### Step 1. Accessing the Add Status Screen

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.

### Step 2. Editing the Add Status Screen

1. 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.

2. (Optional) In the Notes field, enter comments.

3. 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.

4. 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.

5. 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.

   Code | Location | Description
   --- | --- | ---
   L | Local | Cross-reference data is stored within PAC.
   R | Remote | Cross-reference data is copied to the Predict file specified by the application status link.
   B | Both | Cross-reference data is stored within PAC (Local) and is also copied to the Predict file specified by the application status link (Remote).
   N | None | No cross-reference data is maintained.

### Step 3. Selecting Additional Options

1. Access Additional Options by pressing PF4 (Opts), or by typing Y (Yes) over the default.

2. 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.

3. Press ENTER to return to the Add Status screen when you have finished editing the options.

### Step 4. Adding the New Status to PAC

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.

## Displaying/Modifying a Status

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.

## Selecting a Status

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.

## Linking Applications to a Status

You may link several applications to a specified status with the Link Applications to a Status sub-function.

1. 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.

2. 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:

- Selecting Additional Sub-Functions for Linked Applications

- Displaying Applications Linked to a Status

- Displaying Statuses with No Application Links

### Selecting Additional Sub-Functions for Linked Applications

You may select additional sub-functions for linked applications without returning to a menu.

1. 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

2. 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.

3. In the Options window, select the sub-function by entering the relevant code on the command line.

### Displaying Applications Linked to a Status

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.

### Displaying Statuses with No Application Links

You can display a list of statuses not linked to applications by entering Code U (Statuses with No Application Links) on the Status Menu.

## Purging a Status

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.

### On this page

- Adding (Defining) a Status
- Displaying/Modifying a Status
- Selecting a Status
- Linking Applications to a Status
- Purging a Status