Natural API USR1051N

Software AG's platform-independent programming language with full support for open-source and Internet applications

Natural API USR1051N

Postby Arkantos » Wed Sep 01, 2010 2:13 pm


I tried to get the source code of the NATURAL API USR1051N (Interface to various Predict data) from the SYSEXT library and I couldnt able to get that. Could anyone share the code and some information about the API.

Thanks in advance.

Posts: 18
Joined: Fri Apr 16, 2010 10:06 am
Has thanked: 0 time
Been thanked: 0 time

Re: Natural API USR1051N

Postby dick scherrer » Wed Sep 01, 2010 10:54 pm


Unless this is something special, source code is not usually provided by software vendors. . .

The vendor should also have documentation about the api.

Possibly there is something i am missing. . .?
Hope this helps,
User avatar
dick scherrer
Global moderator
Posts: 6269
Joined: Sat Jun 09, 2007 8:58 am
Has thanked: 3 times
Been thanked: 93 times

Re: Natural API USR1051N

Postby RGZbrog » Thu Sep 02, 2010 8:51 am

You can't get hold of the source for USR1051P, but if you could, you would have access to execute USR1051N? How does that make sense? Is this your Natural Administrator's way of securing the user exits? If it's a security issue, I hesitate to get you the code.

How were you trying to get the source, and how did the attempt fail?
User avatar
Posts: 101
Joined: Mon Nov 23, 2009 1:34 pm
Location: California, USA
Has thanked: 0 time
Been thanked: 0 time

Re: Natural API USR1051N

Postby Arkantos » Thu Sep 02, 2010 1:02 pm

I was trying to get the code of USR1051P not USR1051N . Sorry for that. I couldnt able login to the SYSEXT library. As RGZborg said, it might be because of the security issue. But i can run the USR1051P.
Since i cant see the documentation of that USR API, i dont know what are the fields that to be filled as the input. Thats why i was looking for the code of USR1051P.

When I run the USR1051P, I am getting the follwoing map. I was looking some info about the inputs.

Access Predict objects (via an dynamic array)
---------------------------------------------------------- ------- -----
DBID/FNR/Pass/Cipher.. 0_____ / 0_____ / ________ / 0________

Access ............... _ ('S'ELECT/'R'ead/'W'rite/'D'elete/'C'lose)
Use ET/BT logic ...... N ('Y'/'N')
Return line numbers .. Y Replace N ('Y'/'N')
Amount of lines ...... 0___ (1 thru 20) or (1)
Line size ............ 0___ (1 thru 72) (1 thru 900)
PRD Object-Type ...... __ / Info _ / Type of data _ (' ',A,C,D,R,H,N)
PRD object ........... ________________________________
PRD object name 2..... ________________________________
PRD object name 3..... ________________________________
Redefinition of object name 2...
Library ........ ________ / DBID 0_ / FNR 0_
Source name .... ________________________________
Use SPF session nr.... 0___ (instead of the array)
Restrictions ......... _ (used with Access = SELECT)
Timestmp ............. 0000-00-00 00:00
Starting line / seq... 0_______ / 0_____
Posts: 18
Joined: Fri Apr 16, 2010 10:06 am
Has thanked: 0 time
Been thanked: 0 time

Re: Natural API USR1051N

Postby RGZbrog » Thu Sep 02, 2010 1:46 pm

There is very little in the way of documentation within USR1051P. You may have more luck trying to list the documentation/text member, USR1051T.

Also, this may sound very nit-picky, but as a Natural developer, you need to distinguish between "run" and "execute". You must have access to a program's source to run it. (In 3GL parlance, this is a compile-and-go.) And you must have access to a cataloged object in order to execute it.

You are able to execute USR1051P, but would prefer to view and run it, correct?
User avatar
Posts: 101
Joined: Mon Nov 23, 2009 1:34 pm
Location: California, USA
Has thanked: 0 time
Been thanked: 0 time

Re: Natural API USR1051N

Postby Arkantos » Thu Sep 02, 2010 2:18 pm

Correctly said, I have executed the cataloged version. I need to view the code and run it.
Posts: 18
Joined: Fri Apr 16, 2010 10:06 am
Has thanked: 0 time
Been thanked: 0 time

Re: Natural API USR1051N

Postby dick scherrer » Fri Sep 03, 2010 12:37 am


I need to view the code and run it.
Probably not. . . You need to determine the correct inputs and continue to execute (not run). . .

Have you asked AG Support? If not, suggest you do so now.
Hope this helps,
User avatar
dick scherrer
Global moderator
Posts: 6269
Joined: Sat Jun 09, 2007 8:58 am
Has thanked: 3 times
Been thanked: 93 times

Re: Natural API USR1051N

Postby ats » Tue Sep 07, 2010 11:35 am


Your admin might have security setup with SYSEXT and it's few modules. I couldn't get you the source code but the text. It contains all the (user) input details required in USR1051P. I hope this helps.

  Text        USR1051T Library SYSEXT         

 Interface to various PRD data                     PRD
 Name of Interface ..... USR1051N    /*  Cataloged Interface
 Name of Program ....... USR1051P    /*  Example for the Programmer
 Function .............. Interface Program for PRD.
                         This routine gives access on various parts of
                         PRD data. Possible accesses are depending on the
                         PRD object to processed (listed below).
 Keywords .............. FDIC, DESCR, FIELD-LIST, SELECT, PRD
 Extends ...............
              PRD 4.2.1. Layout of object type 'EL' has been changed
 Parameter Layout:
 see PDA  USR1051A
 How to Use the Application Interface:
 The interface 'USR1051N' should be copied to the library 'SYSTEM'
 or the steplib library respectively, or to any application.
 The parameters listed above must be defined via DEFINE DATA in
 structured mode or via RESET in reporting mode.
    Access FDIC of PRD 4.2:
    INFO-TYPE   Possible Acceses      Proccessed Object
    ---------   ------------------    -----------------------------
       'E'      R, S, W, D, C         Description
       'O'         S        C         Objects (UDE or predefined)
       'O'      R, S        C         PRD objects of type 'EL'
 Description of the parameters:
    Input ...... USER
                        Natural-USER. *USER unsuitable in batch in
                        NON-NSC environments, because *USER is Jobname.
                        Definition of the data base environment. If
                        no values are entered, the current FDIC
                        definition is used.
                        This FDIC switching is only active while
                        interface is running.
    Input ...... INFO-TYPE
                        Predict information type.
                        'E' := Ext.Description
                        'O' := Object (UDE or predefined PRD Object)
    Input ...... OBJECT-TYPE
                        Predict object type.
    In/Output .. OBJECT-NAME (A32)
                        Name of the Predict object.
                        Name will be translated to upper case, when
                        switch OBJ-UP of the FDIC is set to 'U'.
    Input ...... OTHER-KEY
                 - OBJECT-NAME-2            redefines OTHER-KEY
                      If OBJECT-TYPE = 'EL' PRD Filename
                      If INFO-TYPE   = 'D'  PRD Filename
                      If INFO-TYPE   = 'D'  PRD Fieldname
                 - IMPL-POINTER             redefines OTHER-KEY
                      If OBJECT-TYPE = 'PR' or ='SY' this field is
                      Usable instead of the OBJECT-NAME
                      MEM-LIB   /* Name of a Natural library
                      MEM-NAME  /* Name of the Natural source
    Input ...... OPT-ACCESS
                        Access type. Possible values are:
                        'S' - Select all objects fitting to the key.
                        'R' - Read data from FDIC.
                        'W' - Write data to FDIC.
                              The existing description will be deleted
                              with the first 'W'rite access.
                        'D' - Delete INFO-TYPE. The access 'C'lose is
                              implicitly performed.
                        'C' - Close processing.
                              After any modifying access 'C'lose-Call is
                              necessary, because the maintenance log and
                              other flags have to be set.
                              After retrieval accesses the 'C'lose-Call
                              is not neccessary. Excepted in a NAT/C
                              environment to force the end of processing.
                              In a data base environment a BT will be
                              Note: A 'C'lose processing must be done
                              between 'R'ead and 'W'rite access
                              to prevent DIC1609 / DIC1068 when 'R'ead
                              and 'W'rite is done in the same program.
    Input ...... OPT-ET
                        Option for transaction handling.
                        ' ' will be handled like 'N'.
                        When OPT-ACCESS = 'S'
                           No ET or BT at all.
                        When OPT-ACCESS = 'R'
                           'Y' - Read with hold option.
                           'N' - Read without hold option.
                        other cases
                           'Y' - ET performed by the subprogram during
                                 the close call. If an error occurrs,
                                 a BT will be issued by the subprogram.
                           'N' - No ET or BT will be performed by
                                 the subprogram
    Input ...... OPT-REPLACE
                        'N' - No replace will be performed.
                        'Y' - Replace if necessary.
                              In the case of OPT-ACCESS='R' (READ)
                              OPT-REPLACE='Y' activate a READ_TO_UPDATE
                              That means all checks will be done, that
                              would prevent the OPT-ACCESS='W'.
    Input ...... OPT-SESNUM
                        = 0 - Use USR1051-SL for data communication.
                        > 0 - Use this SPF session instead of the array.
                        < 0 - Open a SPF session and use this instead
                              of the array (only on PRD33 FDIC)
    Input ...... OPT-LINE-NUM
                        'Y' - Return line numbers. Default is 'Y'.
                        'N' - Do not return line numbers
    Input ...... OPT-AMOUNT
                        Amount of lines requested.
                        Corresponding to the array USR1051-SL.
                        Negative values will be changed to zero.
                        Must be 14 if OBJECT-TYPE = 'EL'
                        and OPT-ACCESS = 'R'
    Input ...... OPT-LINESIZE
                        Length of each line.
                        Value must not be greater than 250.
                        Corresponding to the array USR1051-SL.
                        Must be 70 if OBJECT-TYPE = 'EL'
                        and OPT-ACCESS = 'R'
    In/Output .. OPT-SL-TYPE
                        In case of different data-types communicated by
                        one OPT-ACCESS/INFO-TYPE this parameter will
                        qualify actual data-type stored in USR1051-SL.
0                       When INFO-TYPE ='E':
                        ' ' - Extended description of PRD
                        'A' - Abstract of a PRD object
                        'C' - Natural Construct (CST) specification
    Output ..... FDIC-VERSION
                        '   ' - when given DBID/FNR is no FDIC.
                         nnn  - when the file is a Predict file,
                                nnn is the Predict version number.
    Output ..... TIMESTMP
                        TIMESTMP is set by OPT-ACCESS = 'R'.
                        Time of last modification
                        The value of the field is converted from internal
                        Natural format (T) to (N13).
    In/Output .. NEXT-SEQ, NEXT-NUM
                        The sequence number and the line number to
                        be used as starting value for the next
                        subprogram call.
                        Filled by the subprogram to initialize the
                        next loop. Do not change.
    In/Output .. USR1051-TEXT
                        For internal use. Do not change.
                        In the case of INFO-TYPE ='E'
                        USR1051-TEXT is redefined in:
                   -- FILLER            (A54)
                   -- DESC-SKELETON-USE (A01)  (Output only)
                        'Y'  - PRD default description is read, when a
                               PRD Object without a description was
                               found and OPT-REPLACE = 'Y'
                        'N'  - default description will not be used.
                   -- DESC-FLAG (A01)          (Output only)
                        'D' - ext.descr. disallowed by DDA
                        'F' - ext.descr. exists and ext.descr. is forced
                        'E' - modifiable ext.descr. existing
                        'N' - Object without ext.descr. existing
                        ' ' - No PRD-Object for the ext.desc. found
                   -- DESC-UP (A01)            (Output only)
                        'L' - ext.descr. not translated to upper case
                        'U' - ext.descr. will be translated to upper case
                              Warning: MSG-TYPE=0 and MSG-NR=1554 is set
                        This flag depends on the PRD general defaults |
    Input ...... USR1051-RESTR (A1/1:V)
                        Selection criteria. Just used for OPT-ACCESS='S'.
                        Dynamic array, with redefinition into
                        - the general PRD restrictions;
                        - object type depending selction criteria.
                        USR1051-RESTR is defined as a variable array in
                        interface. So it is possible to call PRD001 with
                        smaller arrays than (A1/1:V), when not all or
                        even no restrictions are used. Possible values
                        instead of V are 3 thru 439.
                        Minimum array is (A1/1:3). In this case
                        RESTR-LENGTH has to be 3.
                        In all other cases RESTR-LENGTH gives number of
                        bytes of USR1051-RESTR(*) that will be processed
                        by interface program.
                        For details of restriction definition see
                        redefinition of USR1051-RESTR(*) in PDA:USR1051A.
                        Description of some fields of this redefinition:
                   -- RESTR-LENGTH (N3)
                           < 4  := No USR1051-RESTR given.
                           > 3  := Used bytes of USR1051-RESTR(*)
                   -- RESTR-LAN (A1)
                        When OBJECT-TYPE = 'PR'
                            Programming language
                        When OBJECT-TYPE = 'EL'
                            Position of language of RESTR-EL-SYNONYM
                   -- RESTR-EL-SORT (A01)
                        Only used for OBJECT-TYPE 'EL'
                           F =  Field list sorted by File
                           else Field list sorted by Field
                   -- RESTR-FI-SEL (A1)
                        File selection criterion
                            M = Only masterfiles
                            R = Only files wich can have related files
                            V = Only DB2 files (tables and views)
    Output ..... SL-RETURN (P03)
                        Number of filled occurrences.
                        For OPT-ACCESS = 'W':
                        0 := means all filled occurrences of SL-TEXT
                             are written, until a negative SL-NUM is
    Output ..... SL-NUM (N04/1:nn), SL-TEXT (A01/1:nn,1:mm),
                        Line number, data line,
                        The upper index of the arrays is variable.
                        nn  corresponds to OPT-AMOUNT;
                        mm  corresponds to OPT-LINESIZE.
                        A negative value in SL-NUM (nn) indicates the end
                        of input data (nn being the first empty line).
                        There is no data in SL-TEXT(nn).
    Output ..... SL-SEQ (B02/1:nn), SL-LONG (A01/1:nn)
                        Sequence number where the line has been found
                        and a long line indicator.
                        SL-LONG (nn) = '-' means that the next line
                        has to be appended.
                        When OPT-ACCESS=R,INFOTYPE=O and OBJECT-TYPE=EL
                        SL-NUM SL-SEQ and SL-LONG will not be used.
                        Only minimum arrays (A1/1:1) are necessary.
    Output ..... USR1051-MSG (group name)
                        Data used for message exchange.
                        MSG (A79)  Keeps the error text
                        MSG-TYPE (I2)
                            0 := Just a message (DIC or NAT)
                            1 := OPT-ACCESS not executed
                                 MSG-NR is a DIC or NAT msg
                            2 := OPT-ACCESS not executed.
                                 MSG-NR isn't a DIC or NAT msg
                                 MSG keeps the error text
                        MSG-NR (I2)
                            =   0 := everything o.k.
                            = 100 := end of data reached
                            >   0 := any DIC message (without above)
                            <   0 := any NAT message
    Output ..... USR1051-FLD (group name)
                        Value of the field in error.
                        For further information see the PDA USR1051A.
                        To be used for cursor position on (RE)INPUT MAP.
    - Select - Layout
         Each selected PRD object is returned in a string of 35 bytes.
         OBJECT-TYPE (A02)
         BLANK       (A01)
         OBJECT-ID   (A32)
         For PRD objects of type EL a string of 68 bytes is returned.
         First 35 bytes see above
         BLANK       (A01)
         FILE-NAME   (A32)
    - Read - Layout for elementary fields
         For each elementary field a string with the following
         layout is returned:
         TYPE             (A2)
         FORMAT           (A2)
         CHARACTER-SET    (A1)
         LENGTH           (N5.2)  /* physical length
         LENGTH-UNIT      (A1)    /* ' ' - bytes
                                  /* 'K' - Kilo bytes
                                  /* 'M' - Mega bytes
                                  /* 'G' - Giga bytes
         OCCURRENCES      (N5)
         SHORT-NAME       (A2)
         HEADER           (A30/1:3)
         SOURCE-FIELD     (A41/1:20)
         CNT-SOURCE-FIELD (N2)
         MASTER-FILE-NAME (A32)   /* Only filled if the field belongs
                                  /* to a file of type 'U' or 'W'
         The layout of every SOURCE-FIELD is as follows
         SC-FIELD-NAME    (A32)
         SC-FORMAT        (A2)
         SC-LENGTH        (N5.2)  /* physical length
    User exits:
    User exits specified below will be used when activated in the Predict
    Please ensure when using USR1051 and running Predict with activated
    user exists, that user exists are available from the library you
    are using USR1051 from.
    - U-MNT
    - U-MNT1
    - U-ACMR
    - U-DESC
 The calling program has to use the following statement:
                    USR1051-RESTR (1:RESTR-LENGTH)
 *****  End of description  *****

Posts: 14
Joined: Mon Sep 06, 2010 12:27 pm
Has thanked: 0 time
Been thanked: 0 time

Return to Natural


  • Related topics
    Last post