Difference between revisions of "H-Spec Keywords"

From MidrangeWiki
Jump to: navigation, search
 
(One intermediate revision by the same user not shown)
Line 2: Line 2:
 
Information via [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books/sc092508.pdf Websphere Development Studio: ILE RPG Reference (PDF)] starting on page 245.
 
Information via [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books/sc092508.pdf Websphere Development Studio: ILE RPG Reference (PDF)] starting on page 245.
  
== Control Specification Statement ==
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085234.htm#HDRHACTGRP ACTGRP(*NEW | *CALLER | 'activation-group-name')]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085235.htm#HDRHALTSEQ ALTSEQ{(*NONE | *SRC | *EXT)}]
=== ACTGRP(*NEW | *CALLER | ’activation-group-name’) ===
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085236.htm#HDRHALWNUL ALWNULL(*NO | *INPUTONLY | *USRCTL)]
The ACTGRP keyword allows you to specify the activation group the program is associated with when it is called. If ACTGRP(*NEW) is specified, then the program is activated into a new activation group. If ACTGRP(*CALLER) is specified, then the program is activated into the caller’s activation group. If an activation-group-name is specified, then that name is used when this program is called.  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085237.htm#HDRHAUT AUT(*LIBRCRTAUT | *ALL | *CHANGE | *USE | *EXCLUDE | 'authorization-list-name')]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085238.htm#HDRHBNDDIR BNDDIR('binding-directory-name' {:'binding-directory-name'...})]
If the ACTGRP keyword is not specified, then the value specified on the command is used.  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085239.htm#HDRHCCSID CCSID(*GRAPH : parameter | *UCS2 : number | *CHAR : *JOBRUN)]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085240.htm#HDRHCOPYN COPYNEST(number)]
The ACTGRP keyword is valid only if the CRTBNDRPG command is used. You cannot use the ACTGRP or BNDDIR keywords when creating a program with DFTACTGRP(*YES).  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085239.htm#HDRHCOPYR COPYRIGHT('copyright string')]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085242.htm#HDRHCURSYM CURSYM('sym')]
'' '''Note:''' The name of the activation group created when the program is called will have exactly the same case as the text entered for the activation-group-name. The RCLACTGRP command does not allow lower-case text to be specified for its ACTGRP parameter. If it is required to reclaim an activation group individually using the RCLACTGRP command then do not enter lower-case case text for the activation-group-name.''  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085243.htm#HDRHCVTOPT CVTOPT(*{NO}DATETIME *{NO}GRAPHIC *{NO}VARCHAR *{NO}VARGRAPHIC)]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085244.htm#HDRHDEDIT DATEDIT(fmt{separator})]
=== ALTSEQ{(*NONE | *SRC | *EXT)} ===
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085245.htm#HDRHDATFMT DATFMT(fmt{separator})]
The ALTSEQ keyword indicates whether an alternate collating sequence is used, if so, whether it is internal or external to the source. The following list shows what happens for the different possible keyword and parameter combinations.  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085246.htm#HDRHDEBUG DEBUG{(*NO | *YES)}]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085247.htm#HDRHDECED DECEDIT(*JOBRUN | 'value')]
* Keyword/Parameter
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085248.htm#HDRHDECPREC DECPREC(30|31|63)]
** Collating Sequence Used
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085249.htm#HDRHDFTACT DFTACTGRP(*YES | *NO)]
* ALTSEQ not specified
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085250.htm#HDRHDFTNAM DFTNAME(rpg_name)]
** Normal collating sequence
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085251.htm#HDRHENBPFR ENBPFRCOL(*PEP | *ENTRYEXIT | *FULL)]
* ALTSEQ(*NONE)  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085252.htm#HDRHEXPROP EXPROPTS(*MAXDIGITS | *RESDECPOS)]
** Normal collating sequence
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085253.htm#HDRHEXTBIN EXTBININT{(*NO | *YES)}]
* ALTSEQ, no parameters
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085254.htm#HDRHFIXNBR FIXNBR(*{NO}ZONED *{NO}INPUTPACKED)]
** Alternate collating sequence specified in source
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085255.htm#HDRHFLTDIV FLTDIV{(*NO | *YES)}]
* ALTSEQ(*SRC)  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085256.htm#HDRHFORMS FORMSALIGN{(*NO | *YES)}]
** Alternate collating sequence specified in source
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085257.htm#HDRHFTRANS FTRANS{(*NONE | *SRC)}]
* ALTSEQ(*EXT)  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085258.htm#HDRHGENLVL GENLVL(number)]
** Alternate collating sequence specified by the SRTSEQ and LANGID command parameters or keywords.
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085259.htm#HDRHINDENT INDENT(*NONE | 'character-value')]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085260.htm#HDRHINTPRC INTPREC(10 | 20)]
If ALTSEQ is not specified or specified with *NONE or *EXT, an alternate collating sequence table must not be specified in the program.  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085261.htm#HDRHLANGID LANGID(*JOBRUN | *JOB | 'language-identifier')]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085262.htm#HDRHNOMAIN NOMAIN]
=== ALWNULL(*NO | *INPUTONLY | *USRCTL) ===
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085263.htm#HDRHOPENOP OPENOPT (*NOINZOFL | *INZOFL)]
The ALWNULL keyword specifies how you will use records containing null-capable fields from externally described database files.
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085264.htm#HDRHOPTIM OPTIMIZE(*NONE | *BASIC | *FULL)]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085265.htm#HDRHOPTION OPTION(*{NO}XREF *{NO}GEN *{NO}SECLVL *{NO}SHOWCPY *{NO}EXPDDS *{NO}EXT *{NO}SHOWSKP) *{NO}SRCSTMT) *{NO}DEBUGIO)]
If ALWNULL(*NO) is specified, then you cannot process records with null-value fields from externally described files. If you attempt to retrieve a record containing null values, no data in the record will be accessible and a data-mapping error will occur.  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085266.htm#HDRHPRFDTA PRFDTA(*NOCOL | *COL)]
 
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085267.htm#HDRHSRTSEQ SRTSEQ(*HEX | *JOB | *JOBRUN | *LANGIDUNQ | *LANGIDSHR | 'sort-table-name')]
If ALWNULL(*INPUTONLY) is specified, then you can successfully read records with null-capable fields containing null values from externally described input-only database files. When a record containing null values is retrieved, no data-mapping errors will occur and the database default values are placed into any fields that contain null values. However, you cannot do any of the following:
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085268.htm#HDRHTEXT TEXT(*SRCMBRTXT | *BLANK | 'description')]
* Use null-capable key fields
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085269.htm#HDRHTHREAD THREAD(*SERIALIZE)]
* Create or update records containing null-capable fields
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085270.htm#HDRHTIMFMT TIMFMT(fmt{separator})]
* Determine whether a null-capable field is actually null while the program is running
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085271.htm#HDRHTRUNC TRUNCNBR(*YES | *NO)]
* Set a null-capable field to be null.  
+
* [http://publib.boulder.ibm.com/infocenter/iseries/v5r3/topic/books_web/c0925085272.htm#HDRHUSRPRF USRPRF(*USER | *OWNER)]
 
 
If ALWNULL(*USRCTL) is specified, then you can read, write, and update records with null values from externally described database files. Records with null keys can be retrieved using keyed operations. You can determine whether a null-capable field is actually null, and you can set a null-capable field to be null for output or update. You are responsible for ensuring that fields containing null values are used correctly.  
 
 
 
If the ALWNULL keyword is not specified, then the value specified on the command is used.  
 
 
 
For more information, see “Database Null Value Support” on page 209
 

Latest revision as of 19:12, 29 November 2005