Handling Input Records › Editing Input Records › Input Record Definition Panel

Input Record Definition Panel

This is the panel where you edit the Input Record Definitions stored in the IRDTAB table. This panel lets you:

• define new fields
• change existing field definitions
• delete individual fields or the entire input record definition

This panel includes protected display fields that carry over from the Input Record Description panel.

When building new input records, define each of the fields your PMA applications will use. This includes the date and time fields DataManager requires as Output Record Header information. DataManager expects these fields to have certain Atr values:

• Dates can use any style date (D, M, Y, J, DC, MC, YC, or JC).
• Times and Durations use Atr values of T, S, N, or H.

Input Record Definition Panel (update mode)

  userid                      CA PMA/DataManager              mm/dd/yy hh:mm:ss
  __     Input  Output  oPtions  Exit  Help
   +-- DMIDESE ----------- Input Record Definition ----------------------------
   |   Panel  Exit  Help                                                       
   | ------------------------------------------------------------------------- 
   |                                                                           
   |  DD Name  . . . . : JARS                                                  
   |  IRD Name . . . . : LEVEL7            More: - + ____   Row: 0001 of 0006  
   |  Description  . . : LEVEL7 HISTORY REC                                                                                   
   | CMD  Field Name         Description           Fmt Atr Offset  Len  Prc   
   |                                                                          
   |  _   JOBNAME            JOB NAME              C   _   1       8    __     
   |  _   STARTDATE          JOB START DATE        N   DC  9       8    __     
   |  _   STARTTIME          JOB START TIME        N   T   17      6    __     
   |  _   STOPDATE           JOB END DATE          N   DC  23      8    __     
   |  _   STOPTIME           JOB END TIME          N   T   31      6      __  
   |  _   ELAPSEDTIME        ELAPSED TIME          N   S   37      8    5      
   |                                                                           
   |    F2=Sort   F5=Save   F6=Delete   F7=Bkwd   F8=Fwd                       
   +---------------------------------------------------------------------------
Command ===> ____________________________________________________________
  F1=Help  F3=Exit  F4=Prompt  F9=Command  F10=Action Bar  F12=Cancel  PA1=Susp

The first time this panel appears, you are in insert mode; the Cmd column is blank, the scroll bar doesn't reflect a row count, and the only active function keys are F5, F7 and F8. When you press F5 (Save), a message tells you that the insert was successful. Now you are in update mode. The scroll bar provides a row count, the Cmd column is active (lines appear in the column), and all function keys are active. Pressing F5 (Save) displays a message that says update was successful.

Access

The Input Record Definition panel appears when one of these events occurs:

• You type II in the fast path area of the Primary Panel; fill in the brief Input Record Description panel; press F2.; fill in the complete Input Record Description panel and press F5.
• You choose Input on the Primary Panel's action bar and select 1. Input Definitions on the Input pull-down. Then you type in selection criteria, press F11 to browse existing records, tab to a record and press Enter.

Scrolling

F7 and F8 let you scroll backward and forward through the Input Record Definition list. You can also use the scroll bar, as explained in Scrolling Lists, to move through the list.

┌──────────────┐
| Input        ├────────┐
| Pull-Down    |        v
|           >1 | ┌───────────────┐
└──────────────┘ | Input Record  |
               ┌─┤ Description   ├────┐
               | | panel     >F2 |    |
          ┌────┤ └────────────┬──┘    |
          |    |         >F11 |       |
          v    └──────────────┘       v
      ┌─────────────┐    ┌───────────────┐
      | Input       |    | Input Record  |
      | Descriptions|    | Description   |
      | List  >Enter|    | (complete) >F5|
      └───┬─────────┘    └───────┬───────┘
          |                      v
          |              ┌───────────────┐
          |              | Input Record  |
          └─────────────>| Definition    |
                         | panel         |
                         └───────────────┘

Caution: You must save your entries using F5 before scrolling the panel. If you do not, the data you have entered isn't saved and is erased from the panel.

Input

CMD

Delete fields by typing a D in this column and pressing Enter. Then confirm the deletion by responding YES in the confirmation window that appears.

Field Name

The name of an input field. Field names must be unique within each record, but different records can have fields with the same name.

Description

Up to 20 characters that describe this input field. (optional)

Fmt

How data values are stored. Type the following letters to specify the format:

B binary

H hexadecimal numeric

C character

P packed

N numeric

X hexadecimal

F flag

Atr

The format of date or time fields:

M   mmddyy   (American)            H   hhhh  (duration)
D   ddmmyy   (European)            N   mmmm  (duration)
Y   yymmdd   (normalized part)     S   ssss  (duration)
J   yyddd    (Julian)              T   hhmmss
MC  mmddyyyy
DC  ddmmyyyy
YC  yyyymmdd (normalized full)
JC  yyyyddd

Valid with Fmt B, N, P, H or C. However, Fmt C does not accept Atr J or JC (see Appendix D).

Offset

The column number where this data field begins in the input record relative to column 1.

Len

The number of columns used to store this data field.

Prec

The number of decimal places to the right of the decimal. (Valid with Fmt B, H, N, or P)

Actions

F2

(Sort) Rearranges this panel by listing fields in alphabetical order.

F3

(Exit) Returns to Input Descriptions List panel.

F5

(Save) Saves your changes to this panel after you respond YES in the confirmation window (Are you sure? YES or NO).

F6

(Delete) Deletes all the fields in this record from the IRDTAB table and deletes this record's description from the IRDDESC table.