HP 3000 Manuals

INTRINSICS [ MPE Segmenter Reference Manual ] MPE/iX 5.0 Documentation


MPE Segmenter Reference Manual

INTRINSICS 

The intrinsic specifications contain the following information:

 *  The intrinsic name.  The word intrinsic, in italics, directly under
    the intrinsic name identifies it as an intrinsic.

 *  A brief summary of the function of the intrinsic.

 *  The complete intrinsic call description, highlighted by enclosure in
    a box.  The format is as follows:

             I           IV     IA
     errnum:=INITUSLF(uslfnum,rec0);

 *  For those intrinsics which return a value to the calling process
    (type procedures), the return is described.  For example, INITUSLF is
    an integer procedure which returns an error number to errnum if an
    error occurs.  The abbreviation, I, over errnum identifies INITUSLF
    as an integer procedure.

 *  All parameters are described.  Required parameters, such as uslfnum 
    above, are shown in bold face italics.  Superscripts (such as IV) are
    used to denote the types of parameters and whether they must be
    passed by value, instead of by reference (the default case).  See
    Section I of the MPE V Intrinsics Reference Manual (32033-90007) for
    a discussion of passing parameters by value and by reference.

    Superscripts have the following meanings:

    I                Integer

    IA               Integer array

    IV               Integer by value

    BA               Byte array

 *  Condition codes are included for each intrinsic.

 *  Text discussion.  (The page in this manual where use of the intrinsic
    is discussed.)

          Table 4-1.  Functional List of Commands and Intrinsics 

                     FUNCTION                         COMMAND OR INTRINSIC 

--------------------------------------------------------------------------------------

Accessing the Segmenter:                              :SEGMENTER
                                                      Combination commands
                                                      such as :COBOLGO,
                                                      :COBOLPREP, :PREPRUN

--------------------------------------------------------------------------------------

General Segmenter commands:

     Terminating interaction with the Segmenter.      -EXIT or -E

     Editing or repeating a Segmenter command.        -REDO

     Obtaining help on a Segmenter command.           -HELP

--------------------------------------------------------------------------------------

Managing USL files:

     Open a USL file as the currently-managed USL     -USL
     file.

     Build a USL file and open it as the currently-   -BUILDUSL
     managed USL file.

     List contents of the USL file.                   -LISTUSL

     Move code modules within the USL file.           -NEWSEG

     Activate/inactivate code modules.                -CEASE/USE

     Hide or reveal RBMs which you will place in an   -HIDE/REVEAL
     SL file.

     Delete code modules.                             -PURGERBM

     Add code modules from a USL file to an RL        -ADDRL
     file.

     Add code modules from a USL file to an SL        -ADDSL
     file.

     Specify auxiliary USL file.                      -AUXUSL

     List contents of auxiliary USL file.             -LISTAUX

     Copy code from one USL file to another.          -COPY

--------------------------------------------------------------------------------------

          Table 4-1.  Functional List of Commands and Intrinsics (Continued) 

                     FUNCTION                         COMMAND OR INTRINSIC 

--------------------------------------------------------------------------------------

     Clean the USL file.                              -CLEANUSL (Calls the CLEANUSL
                                                      intrinsic)

     Copy and enlarge the USL file.                   -COPYUSL

     Initialize a buffer for a USL file to the        INTIUSLF intrinsic
     empty state.

     Move the information block in a USL file.        ADJUSTUSLF intrinsic

     Change the length of a USL file.                 EXPANDUSLF intrinsic

--------------------------------------------------------------------------------------

Managing RLs:

     Open an RL file as the currently-managed file.   -RL

     Build an RL file and open it as the currently-   -BUILDRL
     managed RL file.

     List contents of an RL file.                     -LISTRL

     Add code modules from a USL file to an RL        -ADDRL
     file.

     Delete code modules from an RL file.             -PURGERL

--------------------------------------------------------------------------------------

Managing SLs:

     Open an SL file as the currently-managed file.   -SL

     Build an SL file and open it as the              -BUILDSL
     currently-managed SL file.

     List contents of the SL file.                    -LISTSL

     Add code modules from a USL file to an SL        -ADDSL
     file.

--------------------------------------------------------------------------------------

          Table 4-1.  Functional List of Commands and Intrinsics (Continued) 

                     FUNCTION                         COMMAND OR INTRINSIC 

--------------------------------------------------------------------------------------

     Delete code modules from an SL file.             -PURGESL

     Clean an SL file.                                -CLEANSL

     Clean and enlarge an SL file.                    -COPYSL
--------------------------------------------------------------------------------------

Building Files:

     USL file                                         -BUILDUSL

     RL file                                          -BUILDRL

     SL file                                          -BUILDSL

--------------------------------------------------------------------------------------

Cleaning and enlarging files:

     Clean a USL file.                                -CLEANUSL (calls the CLEANUSL
                                                      intrinsic)

     Clean and enlarge a USL file.                    -COPYUSL

     Initialize a buffer for a USL file to the        -INITUSLF intrinsic
     empty state.

     Move the information block in a USL file.        -ADJUSTUSLF intrinsic

     Change the length of a USL file.                 -EXPANDUSLF intrinsic

--------------------------------------------------------------------------------------

Transferring code modules from one file to another:

     From a USL file to an RL file.                   -ADDRL

     From a USL file to an SL file.                   -ADDSL

     From an auxiliary USL file to the currently-     -COPY
     managed USL file.

--------------------------------------------------------------------------------------

          Table 4-1.  Functional List of Commands and Intrinsics (Continued) 

                     FUNCTION                         COMMAND OR INTRINSIC 

--------------------------------------------------------------------------------------

Adding Code Modules:

     To an RL file from a USL file.                   -ADDRL

     To an SL file from a USL file.                   -ADDSL

--------------------------------------------------------------------------------------

Deleting code modules:

     From a USL file.                                 -PURGERBM

     From an RL file.                                 -PURGERL

     From an SL file.                                 -PURGESL
--------------------------------------------------------------------------------------

Listing File Contents:

     USL                                              -LISTUSL

     Auxiliary USL file                               -LISTAUX

     RL file                                          -LISTRL

     SL file                                          -LISTSL

--------------------------------------------------------------------------------------

Managing FPMAP Information:

     To list FPMAP information.                       -LISTPMAP

     To set or clear the system and the job/session   -SETFPMAP
     FPMAP flags.

     To display the status of the FPMAP flags.        -SHOW

     Translate segment names and procedure names to   FINDPMAPNAME
     segment numbers and offsets.

     Translate segment numbers and offsets to         FINDPMAPADDR
     segment names and procedure names.

     Extract FPMAP from a program or SL file.         DUMPPMAP

--------------------------------------------------------------------------------------



MPE/iX 5.0 Documentation