Read Environment Text Area Variables

Subroutine Name Executable Example Viewable Example

W3READ-ENVIRONMENT-TEXTAREA
W3READ-ENVIRONMENT-TEXTAREA-DYN

E3ENVTX
E3ENVTXD

E3ENVTX
E3ENVTX1
E3ENVTXD
E3ENVTX2

Description

Reads a variable set by a text area tag and separates the text lines.

Parameters
  1. W3READ-ENVIRONMENT-TEXTAREA

    1 W3START            (I4)        /* io/m : Offset to be started at
    *                                /*        out: 0 no occurrences
    *                                /*        out: >0 more occurrences
    1 W3NAME             (A072)      /* i /m : Name of variable
    1 W3VALUESERVER      (A1)        /* i /m : Search for variables in 
    *                                /*        'S' server
    *                                /*        'P' page or URL
    *                                /*        ' ' both
    1 W3ARRAYCOUNTER     (A250/1:V)  /* io/m : Length of array,
                                     /*        returned values
    1 W3ARRAYVALUE       (I4/1:V)    /*  o/m : Value of variables
    1 W3ARRAYVALUELENGTH (I4)        /*  o/m : Length of variables
    1 W3ARRAYMAXIMUM                 /*  o/m : Total number of variables
    
  2. W3READ-ENVIRONMENT-TEXTAREA-DYN

    1 W3START            (I4)              /* io/m : Offset to be started at
    *                                      /*        out: 0 no occurrences
    *                                      /*        out: >0 more occurrences
    1 W3NAME-DYN         (A) DYNAMIC       /* i /m : Name of variable
    1 W3VALUESERVER      (A1)              /* i /m : Search for variables in
    *                                      /*        'S' server
    *                                      /*        'P' page or URL
    *                                      /*        ' ' both
    1 W3ARRAYCOUNTER     (I4)              /* io/m : Length of array,
                                           /*        returned values
    1 W3ARRAYVALUE-DYN   (A/1:V) DYNAMIC   /*  o/m : Value of variables
    1 W3ARRAYVALUELENGTH (I4/1:V)          /*  o/m : Length of variables
    1 W3ARRAYMAXIMUM     (I4)              /*  o/m : Total number of variables
    
How To Invoke
PERFORM W3READ-ENVIRONMENT-TEXTAREA W3START W3NAME
       W3VALUESERVER W3ARRAYCOUNTER(*)
       W3ARRAYVALUE(*) W3ARRAYVALUELENGTH(*)
       W3ARRAYMAXIMUM

PERFORM W3READ-ENVIRONMENT-TEXTAREA-DYN W3START W3NAME-DYN
       W3VALUESERVER W3ARRAYCOUNTER(*)
       W3ARRAYVALUE-DYN(*) W3ARRAYVALUELENGTH(*)
       W3ARRAYMAXIMUM