PA and PF Keys in UFO
search cancel

PA and PF Keys in UFO

book

Article ID: 9705

calendar_today

Updated On:

Products

UFO

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.