PA and PF Keys in UFO
Article ID: 9705
Updated On:
Products
Issue/Introduction
UFO recognizes a request for action when the user presses enter or any one of the PA or PF interrupt keys or when a Function Identifier (FID) is entered into the screen command field.
UFO provides a default association between a PA/PF key and a FID. The default assignment of keys can be modified and overridden for either:
- the entire UFO system
- a specific application
Resolution
Default PA and PF Keys and Their Function
The table that follows shows the default PA and PF key functions (FID value) in CA UFO. To illustrate further, the action of the key when in the commonly used utilities UFOEDD and UFOEDIT are also shown. The UFOEDD utility is used to create, review, and update Display Definitions (DD). The UFOEDIT utility is used to create, review, and update Procedures (PDS).
| Key | Short Form of Function (FID) | Function Performed | Function in UFOEDD | Function in UFOEDIT |
| PF1 | U | Auto access update | Updates DD | Updates PDS |
| PF2 | A | Auto access add | Adds new DD | Adds new PDS |
| PF3 | LOCAL | Report or screen print | Prints current DD at local printer | Prints current PDS at local printer |
| PF4 | R | Auto access record copy | Copies current DD | Copies current PDS |
| PF5 | M | Auto access modify (Add or Update) | Displays the continuation DD | Displays the continuation PDS |
| PF6 | MAINMENU | Return to main menu of application | Changes the name of DD | Changes the name of PDS |
| PF7 | MENU | Return to previous menu | (No function) | (No function) |
| PF8 | DISPLAY | Transfer to new screen using key at cursor | Executes ACB or if no ACB, executes UFOEDD | Executes ACB or if no ACB, executes UFOEDIT |
| PF9 | SELECT | Simulate light pen selection | Returns to calling DD | Returns to calling PDS |
| PF10 | HELP | Display Help (or return from Help) | Help | Help |
| PF11 | I | Auto access insert mode | (No function) | (No function) |
| PF12 | IE | Display last entered Initial Entry syntax | (No function) | (No function) |
| PA1 | +1R | Auto access browse forward (NEXT) | Displays next DD | Displays next PDS |
| PA2 | AUTO | Auto access automatic browse | Cancels all modifications since last save | Cancels all modifications since last save |
| PA3 | -1R | Auto access browse backward (PREV) | Displays previous DD | Displays previous PDS |
| ENTER | * | (No function) | (No function) | (No function) |
| CLEAR | END | Program termination | Exit | Exit |
Changing the UFO Defaults for the Entire UFO System
The default PA or PF key assignment or the key associated with a function (FID) for the entire UFO system can be customized, if desired. UFO provides the control tables and their macros to allow for this customization.
Table UFOAID
Table UFOAID is the control table used to equate a PA or PF key to another. The UFOAID control table is generated using the UFMAAID macro, assembling the statements to rebuild the module/phase named UFLAAI32.
Here is a sample OS/390 JCL assembly and link edit job stream. The example uses the UFMAAID macro statement to change the function of PA2 from the UFO default of Auto Browse to the CLEAR action and then rebuilds module UFLAAI32:
//ASM EXEC PGM=ASMA90,PARM=OBJ
//SYSLIB DD DSN=your.UFO.MACLIB,DISP=SHR
//SYSUT1 DD DSN=&&SYSUT1,UNIT=VIO,SPACE=(1700,(600,100))
//SYSUT2 DD DSN=&&SYSUT2,UNIT=VIO,SPACE=(1700,(300,50))
//SYSUT3 DD DSN=&&SYSUT3,UNIT=VIO,SPACE=(1700,(300,50))
//SYSPRINT DD SYSOUT=A
//SYSPUNCH DD SYSOUT=B
//SYSLIN DD DSN=&&OBJSET,UNIT=SYSDA,SPACE=(80,(200,50)),
// DISP=(MOD,PASS)
UFMAAID TYPE=INTITAL
UFMAAID USER=PA2,UFO=CLEAR
UFMAAID TYPE=FINAL
END
/*
//LKED EXEC PGM=IEWL,COND=(8,LT,ASM),
// PARM='XREF,LET,LIST,NCAL,AMODE=24,RODE=24'
//SYSLIN DD DSN=&&OBJSET,DISP=(OLD,DELETE)
// DD DDNAME=SYSIN
//SYSUT1 DD DSN=&&SYSUT1,UNIT=VIO,SPACE=(1024,(50,20))
//SYSPRINT DD SYSOUT=*,DCB=(RECFM=FB,LRECL=121,BLKSIZE=1210)
//SYSLMOD DD DSN=your.loadlib (UFLAAI32) ,DISP=SHR
Table UFOATF
Table UFOATF is the control table used to equate a PA or PF key to a function (FID). The UFOATF control table is generated using the UFMAATF macro, assembling the statements to rebuild the module/phase UFLAAT32. Here are sample UFMAATF macro statements showing the assignment of PF7 to the "-1R" function (screen backward) and PF8 for "+1R" function (screen forward).
UFMAATF TYPE=INTITAL
UFMAATF UFO=PF7,USER=-1R
UFMAATF UFO=PF8,USER=+1R
UFMAATF TYPE=FINAL
END
Changing the Defaults for a Single UFO Application
The default PA or PF key associated with a function (FID) for a specific application can be overridden in the application DDX (Display Definition Extension) or in the application DDXI (DDX Interrupt).
NOTE: For the specific application, any UFOAID and UFOATF customization as well as the UFO defaults are overridden.
Refer to the DDX screen display that follows and the VALUE, FUNCTION, ACBNAME and KEY columns in the bottom right. PA and PF keys and their desired function are entered in this area (or in the DDXI screen not shown in this article). This example assigns PF7 to the "-1R" function (screen backward) and PF8 to "+1R" function (screen forward) for the DDX named TESTDDX.
Feedback
