|
|
|
DataManager provides many predefined records that your PMA applications can use. However, you may want your PMA application to include other data collected at your site. This example shows how to define the following record for DataManager use.
Using the fast path, you can start building a record by typing II on the Primary Panel and pressing Enter. This displays a blank Input Record Description panel. The first step in defining a new input record is describing the new IRD using this panel. ┌──────────────┬──────────┬────────────┐ | | Field | | | Field Name | Position | Data Format| ├──────────────┼──────────┼────────────┤ | Jobname | 1-8 | Character | | Start date | 9-16 | yyyymmdd | | Start time | 17-22 | hhmmss | | Stop date | 23-30 | yyyymmdd | | Stop time | 31-36 | hhmmss | | Elapsed time | 37-44 | sss.sssss | | CPU time | 45-52 | mmm.mmmmm | | I/O DBs | 53-57 | Integer | | EXCPs | 58-62 | Integer | └──────────────┴──────────┴────────────┘
Input Record Description Panel
userid CA PMA/DataManager mm/dd/yy hh:mm:ss __ Input Output oPtions Exit Help +-- DMIDESP ------Input Record Description ------------- º Panel Exit Help º ----------------------------------------------------- | Enter a New Input Record Description or Browse IRDs | º DD Name . . . . . OURDATA º IRD Name . . . . . OURSITE º º > F2=Create F11=Browse +------------------------------------------------------- Command ===> ____________________________________________________________ F1=Help F3=Exit F4=Prompt F9=Command F10=Action Bar F12=Cancel PA1=Susp
To describe this new IRD, type over the underscores and fill in values for DD Name and IRD Name.
Then press F2 to create this new input record description. F2 then displays the complete Input Record Description panel.
The values you input on the last panel are displayed in protected fields on the complete Input Record Description panel and the Input Record Definition panel.
Input Record Description Panel (complete)
userid CA PMA/DataManager mm/dd/yy hh:mm:ss __ Input Output oPtions Exit Help +-- DMIDESD ------Input Record Description ------------- | Panel Exit Help | ----------------------------------------------------- | Enter Input Record Description | | DD Name . . . . : OURDATA | IRD Name . . . . : OURSITE | | Description . . . OUR PERFORMANCE DATA | Length of Record . 70 | Input ID | Starting Position _____ | ID Length . . . . __ | ID Hex Value . . ____________________ | | F5=Save F11=Definition +------------------------------------------------------- Command ===> ____________________________________________________________ F1=Help F3=Exit F4=Prompt F9=Command F10=Action Bar F12=Cancel PA1=Susp
Only one field on this panel requires input: Length of Record. Length of Record tells the number of characters in this type record. This data set can store different type records of varying lengths, each type identified by a unique IRD Name and its own length.
If this data set contains more than one type of record, fill in the Input ID information to identify this record type. This information tells DataManager that these type records all have the same code in a specific field. Starting Position tells the number of the column where the identifying code starts. ID Length tells the number of characters in this identifying code. ID Hex Value specifies the identifying code in hexadecimal representation.
When you've filled in the appropriate information on this panel, press F5 to save this description and proceed with defining this IRD. F5 displays a blank Input Record Definition panel, ready for input field definitions.
Input Record Definition Panel
userid CA PMA/DataManager mm/dd/yy hh:mm:ss __ Input Output oPtions Exit Help +-- DMIDESE ----------- Input Record Definition ---------------------------- | Panel Exit Help | ------------------------------------------------------------------------- | | DD Name . . . . : OURDATA | IRD Name . . . . : OURSITE More: - + ____ Row: 0000 of 0000 | Description . . : OUR PERFORMANCE DATA | | Field Name Description Fmt Atr Offset Len Prec | | ________________ ____________________ __ __ _____ __ __ | ________________ ____________________ __ __ _____ __ __ | ________________ ____________________ __ __ _____ __ __ | ________________ ____________________ __ __ _____ __ __ | ________________ ____________________ __ __ _____ __ __ | ________________ ____________________ __ __ _____ __ __ | | 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
To define a field, just type over the underscores and fill in the Field Name, Fmt, Atr, Offset and Len values:
mmddyy (American)
hhhh
ddmmyy (European)
mmmm
yymmdd (normalized part)
s.ss (duration to 1/100 second)
yyddd (Julian)
hhmmss
mmddyyyy
ddmmyyyy
yyyymmdd (normalized full)
yyyyddd
binary
hexadecimal numeric
character
packed
character numeric
hexadecimal
flag byte
If a field has decimal places, specify how many under Prec. The Description field is optional. After you've finished filling in the field's information, press F5 to save that field. DataManager will display a message if it has trouble processing any of your input.
| Field Name Description Fmt Atr Offset Len Prec | | 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=Back F8=Fwd > +--------------------------------------------------------------------------- Command ===> ____________________________________________________________ F1=Help F3=Exit F4=Prompt F9=Command F10=Action Bar F12=Cancel PA1=Susp
You can wait until you've defined six new fields on the panel before saving.
Caution: You must save your entries using F5 before scrolling the panel. If you do not, the data you have entered will be cleared from the panel.
After saving the first six field definitions, you can scroll down and define the rest of the fields in this record.
| Field Name Description Fmt Atr Offset Len Prec | | CPUTIME CPU DURATION N N 45 8 5 | I/O DBS I/O DBS N _ 53 5 __ | EXCPS EXCPS N _ 58 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
Be sure to press F5 again to save these field definitions, too.
You don't have to add fields in any particular order. However, you can display fields in alphabetic order by pressing F2.
| CMD Field Name Description Fmt Atr Offset Len Prec | | _ CPUTIME CPU DURATION N N 45 8 5 | _ ELAPSEDTIME ELAPSED TIME N S 37 8 5 | _ EXCPS EXCPS N _ 58 5 __ | _ I/O DBS I/O DBS N _ 53 5 __ | _ JOBNAME JOB NAME C _ 1 8 __ | _ STARTDATE JOB START DATE N DC 9 8 __ | | F2=Sort F5=Save F6=Delete F7=Back F8=Fwd > +--------------------------------------------------------------------------- Command ===> ____________________________________________________________ F1=Help F3=Exit F4=Prompt F9=Command F10=Action Bar F12=Cancel PA1=Susp
Always define input records before output records.
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |