PA and PF Keys in CA UFO

Document ID : KB000009705
Last Modified Date : 14/02/2018
Show Technical Document Details
Introduction:

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

CA 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 CA-UFO system

  • a specific application
Instructions:

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

KeyShort Form of Function (FID)Function PerformedFunction in UFOEDDFunction in UFOEDIT
PF1UAuto access updateUpdates DDUpdates PDS
PF2AAuto access addAdds new DDAdds new PDS
PF3LOCALReport or screen printPrints current DD at local printerPrints current PDS at local printer
PF4RAuto access record copyCopies current DDCopies current PDS
PF5MAuto access modify (Add or Update)Displays the continuation DDDisplays the continuation PDS
PF6MAINMENUReturn to main menu of applicationChanges the name of DDChanges the name of PDS
PF7MENUReturn to previous menu(No function)(No function)
PF8DISPLAYTransfer to new screen using key at cursorExecutes ACB or if no ACB, executes UFOEDDExecutes ACB or if no ACB, executes UFOEDIT
PF9SELECTSimulate light pen selectionReturns to calling DDReturns to calling PDS
PF10HELPDisplay Help (or return from Help)HelpHelp
PF11IAuto access insert mode(No function)(No function)
PF12IEDisplay last entered Initial Entry syntax(No function)(No function)
PA1+1RAuto access browse forward (NEXT)Displays next DDDisplays next PDS
PA2AUTOAuto access automatic browseCancels all modifications since last saveCancels all modifications since last save
PA3-1RAuto access browse backward (PREV)Displays previous DDDisplays previous PDS
ENTER*(No function)(No function)(No function)
CLEARENDProgram terminationExitExit

Changing the CA 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 CA UFO system can be customized, if desired. CA 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 CA 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 CA 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 CA 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.

Figure 1

Additional Information:

Read More About It

For more information on PA and PF keys within CA UFO, control tables including UFOAID and UFOATF, and DD, DDX and PDS, refer to the UFO Productivity System Reference Manual publications

Customization and OperationĀ 
Application Programmer GuideĀ 
UtilitiesĀ 
System Quick Reference Summary