YCHGMDLVAL (Change Model Value) Command

ca2e87
Changes a model value.
Contents
Required
YCHGMDLVAL (Change Model Value) Command - Required
Parameters
The following are parameters for the YCHGMDLVAL command.
MDLVAL
Name of model value that is changed. One of the model values.
VALUE
Value that the model value is changed to.
Notes
Initial values for model values are set by the parameters specified when the command Create Model Library (YCRTMDLLIB) was run
On the following page is an alphabetical listing of model values. You can then find related values grouped according to the tables below:
  • Design Option Values
  • Name Allocation Values
  • Access Path Generation Values
  • Function Generation Values
  • Environment Values
  • Help Generation Values
  • PWS Environment Values
  • System Defaults
  • Protected Model Values
  • Unchangeable System Model Values
Model Values in Alphabetical Order
Model Value
Description
Grouping
YABRNPT
Action/DDS Menu Bars
Design Option
YACTCND
Action diagram compound symbols
Design Option
YACTFUN
Action diagram compute symbols
Design Option
YACTSYM
Action diagram structure symbols
Design Option
YACTUPD
Default update flag value on action diagram exit
Environment
YALCVNM
Automatic name allocation
Name Allocation
YBNDDIR
ILE Binding directory
Environnent
YCHGCTL
Change control library
Environment
YCMPCHG
Component change processing control
Environment
YCMPTXT
Company text
Environment
YCMTCDE
Include Inactive Code
Environment
YCNFVAL
Confirm value
Function Generation
YCPYLIB
Copy library
Environment
YCPYMSG
Copy back messages
Function Generation
YCRTENV
Creation environment
Environment
YCRTJBD
Job description
Environment
YCUAEXT
CUA device extension
Design Option
YCUAPMT
CUA prompt
Design Option
YCUTOFF
Date range for 2-digit year input dates
Function Generation
YDATFMT
Date format
Function Generation
YDATGEN
Date generation
Function Generation
YDBFACC
Database access method
Access Path Generation
YDBFGEN
Database implementation
Access Path Generation
YDDLDBA
Database access method
Function generation
YDFTCTX
Parameter default context
Function Generation
YDSTFIO
Distributed file I/O control
Environment
YERRRTN
Error routine
Function Generation
YEXCENV
Execution environment
Environment
YFILPFX
File name prefix
Name Allocation
YFRFPFX
Field reference prefix
Access Path Generation
YFRFTXT
Field reference file text
Access Path Generation
YFRFVNM
Field reference file name
Access Path Generation
YGENCMT
Generate comments in source
Function Generation
YGENGUI
Generate GUI by default (Synon/TC
Function Generation
YGENHLP
Generate help text
Function Generation/ Help Generation
YGENLIB
Generation library
Environment
YGENLMT
Maximum job list entries for single YGENSRC job
Function Generation
YGENRDB
Generation RDB name
Environment
YGUIAKY
Suppress aid keys (Synon/TC
PWS Environment
YGUICMD
Command key descriptor text (Synon/TC
PWS Environment
YGUIFLR
Folder for GUI objects (Synon/TC
PWS Environment
YGUIHLP
Default GUI help language (Synon/TC
Help Generation
YGUILIB
Library partitioning for GUI (Synon/TC
PWS Environment
YGUILSO
Suppress list options (Synon/TC
PWS Environment
YGUIOPR
Operator between prefix & text (Synon/TC
PWS Environment
YGUISEL
Subfile select descriptor text (Synon/TC
PWS Environment
YGUITKY
Display command keys per tab (Synon/TC
PWS Environment
YHLLCBL
HLL Cobol
Function Generation
YHLLGEN
HLL to generate
Function Generation
YHLLVNM
HLL naming convention
Name Allocation
YHLPCSR
Generate cursor sensitive text
Help Generation
YIGCCNV
IGC support
Environment
YLHSFLL
Leaders for device design
Design Option
YLIBLST
Model library list name
Environment
YMDLLIB
Model library
Environment
YMDLLNG
Model language
Environment
YMDLTXT
Model text
Environment
YMSGNBR
Message number
Name Allocation
YMSGPFX
Message id prefix
Name Allocation
YMSGVNM
Message file name
Name Allocation
YNLLMDL
Null model
Unchangeable System Model Value
YNLLUPD
Null update suppression
Function Generation
YNPTHLP
NPT help default generation type
Help Generation
YOBJPFX
Member name prefix
Name Allocation
YOLDDBF
Old DBF names
Access Path Generation
YOLDLIB
Old library
Environment
YOPNACC
Open access to the model
Environment
YPKYLIB
Print key file library
Function Generation
YPKYVNM
Print key file
Function Generation
YPMTGEN
Prompt implementation
Function Generation
YPMTMSF
Prompt message file
Name Allocation
YPMTNBR
Prompt number
Name Allocation
YPUTOVR
DDS put with override
Function Generation
YRPGHDR
RPG header specification
Function Generation
YRPGHSP
RPG Control (H) Specification
Function Generation
YRP4HSP
RPGIV Control (H) Specification (*PGM)
Function Generation
YRP4HS2
RPGIV Control (H) Specification (*MODULE)
Function Generation
YRP4SGN
RPGIV Generation Options
Function Generation
YSAAFMT
SAA format
Design Option
YSCNLMT
Scan Limit
Function Generation
YSFLEND
Subfile end
Design Option
YSHRDFT
Sharing default
Design Option
YSHRSBR
Share function subroutines
Function Generation
YSNDMSG
Send error message
Function Generation
YSQLFMT
Generate SQL RCDFMT clause
Function Generation
YSQLLCK
SQL locking
Function Generation
YSQLLEN
SQL naming length
Access Path Generation
YSQLLIB
SQL collection library
Environment
YSQLVNM
SQL naming
Access Path Generation
YSQLWHR
SQL Where clause
Function Generation
YSYSCHG
Change control library
System Defaults
YSYSDBF
System database access
System Defaults
YSYSHLL
Default HLL
System Defaults
YSYSLNG
System language
Unchangeable System Model Value
YSYSNPT
System default NPT help generation type
System Defaults
YSYSPMT
System prompt
System Defaults
YSYSSAA
Default SAA formatting option
System Defaults
YTRGLIB
Trigger Runtime library
Environment
YTRNAPI
Convert Case API
Function Generation
YUIMBID
Bi-directional UIM help text
Help Generation
YUIMFMT
Default UIM format
Help Generation
YUIMIDX
UIM search index
Help Generation
YVLSPFX
Value list prefix
Name Allocation
YWBDATR
Window border attribute
Design Option
YWBDCHR
Window border characters
Design Option
YWBDCLR
Window border background color
Design Option
YWSNGEN
Workstation environment
Function Generation
YW2ELIB
Web Option Product Library
Function Generation
Model Values Grouped By Role
Following are the model values grouped according to their role.
Design Option Values
Model Value
Description
Allowed Values
YABRNPT
Allows you to choose between creation of
CA 2E
Action Bars or DDS Menu Bars for a given function.
*DDSMNU
*ACTBAR
YACTCND
Symbols used in editing a compound condition.
5 pairs of up to 3 characters each used to represent the edit and display values for logical operators and parenthesis. Then, up to 3 characters for the conditions.
YACTFUN
Symbols used in editing a compute expression.
8 sets of up to 3 characters each separated by blanks used to represent the arithmetic operations, parenthesis and functions.
YACTSYM
Symbols used to indicate the action diagram symbols :, |, . Used in action diagram editor and YDOCMDLFUN.
*SAA -- Default to symbols, :, |, , or you can pick three symbols of your own choice.
See the notes that follow.
YCUAEXT
For panel device designs, defines whether right-hand side text, provision for instructions area on entry panels, and padding of field label trailers will be used as a default.
*C89EXT -- This value will provide right-hand side text and extra spacing in line with the 1989 CUA extensions.
*DEFAULT -- This value will not provide right-hand side text and extra spacing.
YCUAPMT
Enables the CUA prompt. The default is F4.
*MDL -- Will pick it up from YSAAFMT. If YSAAFMT = CUATEXT, F4 will be enabled within the generated application.
*YES -- F4 will be enabled within the generated application.
*NO -- F4 will not be enabled.
*CALC -- See the notes that follow.
YLHSFLL
Symbols to be used as leaders between screen text and screen fields.
*SAA -- Will provide default left-hand side filler characters for input and output fields or you can pick characters of your own choice. See the notes that follow.
YSAAFMT
Screen device convention to be defaulted for use in the device design editor. (System/38, CUA Entry, or CUA Text)
*CUAENTRY -- Defaults to a header/footer without windows or action bars.
*CUATEXT -- Defaults to windows and action bar style header/footers. All function types with the exception of SELRCD will default to action bars. THE SELRCD will default to a window.
*S38 -- Defaults to System/38 style header/footer.
YSFLEND
Controls whether + or More. . . is displayed if additional subfile records are available for display.
*PLUS -- Display the + sign to indicate that the subfile contains more records.
*TEXT -- Display More. . . to indicate that the subfile contains more records. Display Bottom to indicate that the last subfile record is displayed.
YSHRDFT
Defines the sharing default for the model when editing file relations. This affects how key fields are shared by default when the key field is already present in the file.
*ALL -- All keys that match existing fields, other than the last key of the relation, are automatically shared.
*NONE -- No keys are automatically shared.
This is a recommended default when using Gateway/SR.
YWBDATR
Window border attribute that is to be the default for device designs.
*CUA -- Shadowed window.
*SHADOW -- Shadowed window.
*NOSHADOW -- Straight lined window.
YWBDCHR
Window border characters. The field length is 8, with each number referencing a border section:
1 Top left corner character
2 Horizontal top line
3 Top right corner character
4 Vertical left line character
5 Vertical right line character
6 Bottom left corner character
7 Horizontal bottom line
8 Bottom right corner character
*CUA -- Dots provided at the top and bottom, colon at the left and right.
CHAR (8) -- You can choose which characters you want for each border section. See the notes that follow.
YWBDCLR
Window border background color.
*CUA -- Default color is blue.
*RED, *GRN, *WHT, *PNK, *TRQ, *YLW, *BLU
YACTSYM
YACTSYM is made up of three characters:
  • The symbol used to indicate iteration brackets in action diagrams
  • The symbol used for sequence brackets
  • The symbol used for condition brackets
The three characters are shipped with the following initial values:
  • Iteration..: '|'
  • Sequence...: ':'
  • Condition..: ' '
YCUAPMT
The *CALC value for YCUAPMT enables F4 prompting in the generated application, and processes the CALC: user points in the action diagram of the function where you pressed F4. The main use for this feature is to provide Retrieve Condition functionality (*RTVCND built-in function) when you press F4.
Note:
If you have Retrieve Condition logic within a USER: user point that you want processed when you press F4, you will need to move the logic to a CALC: user point.
If a CALC: user point contains logic that you do not want processed when you press F4, you can bypass the logic by checking for the F4 prompt condition. For example:
>CALC:
. - -
. DTL.Gender name = Condition name of DTL.Gender <<<
. + - CASE <<<
. | - DTL.*CMD key is *Prompt <<<
. | - *OTHERWISE <<<
. | : <<<
. | (Actions to be bypassed when you press F4=Prompt) <<<
. | : <<<
. + - ENDCASE <<<
Note: Some function types contain logic that reinitializes function fields as shown in the following table. As a result, if you bypass function field calculation, when you press F4 the function fields will be reinitialized but not recalculated.
Function Type
Function Field Initialization
PMTRCD
DSPFIL
SELRCD
No
No
No
DSPRCD,2,3
EDTRCD, 2,3
EDTFIL
DSPTRN
EDTTRN
Yes
Yes
Yes
Yes
Yes
The action diagram logic that processes the key screen for the following functions does not contain a CALC: user point:
  • DSPRCD
  • DSPRCD2
  • DSPRCD3
  • EDTRCD
  • EDTRCD2
  • EDTRCD3.
As a result, to process Retrieve Condition logic before processing the detail screens for these functions you can:
  • Set the Bypass Key Screen function option for the function to Y.
  • Create a Prompt Record (PMTRCD) function that includes the Retrieve Condition logic at its CALC: user point and calls the Display Record or Edit Record function to process the detail screen.
YLHSFLL
YLHSFLL takes either the special value *SAA, indicating that the SAA convention is to be used (. . . :), or a 9 character string is specified, typically :.:..:..:. The first character (":" in the example) is used as the leader on screen designs when there is one space between the text and the following field. The next two characters (".:") are used when there are two spaces between the text and the following field. The next three characters ("..:") are used when there are three spaces between the text and the field. The final three characters ("..:") are used when there are more than three spaces, with the middle character being repeated as required.
YWBDCHR
YWBDCHR is made up of eight characters that correspond to the eight sides and corners of a window frame as follows:
Character
Position
Value
5
Top left corner
.
1
Top horizontal
.
6
Top right corner
.
3
Left vertical
:
4
Right vertical
:
7
Bottom left corner
:
2
Bottom horizontal
.
8
Bottom right corner
:
Name Allocation Values
Model Value
Description
Allowed Values
YALCVNM
Specifies whether field and object names are to be allocated automatically by
CA 2E
*YES
*NO
*MNC -- Will be allocated mnemonically. See the note that follows this table.
YFILPFX
The Last Used File Prefix (YFILPFX) model value contains the last two-character identifying mnemonic
CA 2E
used when creating a new file. These two characters occupy positions three and four of the new file name, following the model object prefix.
Two-character prefix.
YHLLVNM
Specifies HLL or HLLs with which new names will comply.
*RPG
*CBL
*RPGCBL -- Allocate both RPG and Cobol.
*VNM -- Same language as YHLLGEN option is allocated.
YMSGNBR
The last assigned message number in the message file named by YMSGVNM.
AAAA to 9999
YMSGPFX
Message prefix to be given to message identifiers issued automatically by
CA 2E
.
Message prefix or *NO
VNM(3)
YMSGVNM
Name of default message file in GENLIB to place message descriptions in.
*NONE
*MSGPFX
VNM(10)
YOBJPFX
Prefix to use when generating system object names.
Two-character prefix that will be attached to your generated objects.
YPMTMSF
Device prompt message file.
Valid System Name -- Specify your own.
*NONE
*PMTMSF -- Default name provided.
YPMTNBR
The last assigned prompt message number in the message file named by YPMTMSF.
0001 to 9999
YVLSPFX
Prefix to be given to value list profile and the program that calls it. See YCVTCNDVAL.
Two-character prefix
Note: If you set the model value for YALCVNM to *MNC, a column of input fields is created on the define objects panel. Place an M in this column and the newly defined object name will be added to a file of object names or mnemonics of 1, 2, and 3 characters. The three variants can then be defined and made available to the name allocation program
Access Path Generation Values
Model Value
Description
Allowed Values
YDBFACC
Specifies whether data is accessed using the SQL table directly or an SQL view.
*DBFGEN -- Access data using a view.
*TABLE -- Access data directly from the SQL table.
YDBFGEN
Defines the method for database definition, either DDS, SQL or DDL. The default is the value defined by the YSYSDBF model value.
*DDS
*SQL
*DDL
YFRFPFX
Prefix for fields in field reference file.
Valid System Name -- Specify your own.
YFRFTXT
Text for field reference file.
Character string
YFRFVNM
Name of field reference file.
Valid System Name or *NONE
YOLDDBS
Controls display of the old DBF name field on the Edit Field Details display.
*YES -- Display YES.
*NO -- Display NO.
YSQLLEN
Controls the length of the extended SQL name.
A numeric value up to 25.
This model value is used only when YSQLVNM is *SQL.
YSQLFMT
Specifies whether the RCDFMT keyword must be generated for SQL tables, views, and indexes.
*NO
*YES
YSQLVNM
Specifies whether to assign DDS names or model object names to SQL tables and columns.
*DDS -- Use DDS names.
*SQL -- Use the names of the
CA 2E
model objects; in other words, use extended SQL naming.
*LNG -- Use the long names of the
CA 2E
objects in the model along with the DDS or implementation names.
*LNF -- Use the long field names of the
CA 2E
objects in the model along with the DDS or implementation names.
*LNT -- Use the long table names of the
CA 2E
objects in the model along with the DDS or implementation names.
Function Generation Values
Modern value
Description
Allowed values
YCNFVAL
Specifies initial value for confirm prompt
*YES
YCPYMSG
Specifies whether outstanding messages are to be copied back to the calling program.
*YES
*NO
YCUTOFF
Specifies the first of 100 consecutive years that can be entered as 2 digit years. It is specified as 19YY, which represents the hundred years 19YY to 20YY-1. Values between YY and 99 are assumed to be in the 20th century; values between 00 and YY-1 are assumed to be in the 21st century.
1940
19YY -- where YY is a numeric value between 00 and 99; in other words, a 4-digit year between 1900 and 1999
YDATFMT
Specifies the display format for dates at run time (DMY, YMD, MDY) if YDATGEN = *VRY was specified. It is stored as Y2DTFMA data area in GENLIB.
*DMY -- Date, Month, Year
*YMD -- Year, Month, Date
*MDY -- Month, Date, Year
YDATGEN
Date validation generation option: MDY, YMD, DMY, VRY - if VRY see YDATFMT value
*DMY
*YMD
*MDY
*VRY
YDDLDBA
*RLA --
*SQL --
YDFTCTX
Specifies the default context to be used for a given function call in the action diagram editor when no context has been supplied by the user.
*WRK -- Use WRK context for parameter defaulting.
*LCL -- Use LCL context for parameter defaulting.
YERRRTN
Specifies whether an error handling routine is to be generated.
*YES -- Generate error handling routine.
*NO -- Do not generate error handling routine.
YGENCMT
Determines whether or not comments are placed in the resulting generated source code. The time required to generate a function can be significantly improved if comments are not required for the source. Note: Refer to the YGENHLP model value for another method that can be used to improve function generation times.
*ALL -- All comments are generated into the source for a function.
*HDR -- Only header comments are generated.
*NO -- No comments are generated.
*STD -- Currently the same as *ALL. To be used in a future release.
YGENGUI
Generate GUI by Default. Indicates whether to generate SDF source for functions that use a screen device design. This applies to all programmable workstation functions; namely, if the YWSNGEN model value is set to *GUI, *VB, or *JVA. YGENGUI is ignored when YWSNGEN or its function option is set to *NPT.
For Synon/TC, also indicates whether to generate Windows Help and depends on YGENHLP. See YGENHLP.
*YES -- Generate a GUI interface for functions that use a screen device design.
*NO -- Do not generate a GUI interface.
*ONLY -- Generate only a GUI interface that use a screen device design. For functions where SDF is not applicable, for example, Print File functions, no source is generated.
YGENHLP
Determines whether help will be generated/created by default for functions in the model. This can be overridden by a function option. For Synon/TC the result depends on YGENGUI. See YGENHLP.
*YES -- Generate help text (UIM or TM) with all other HLLs.
*NO -- Do not generate help text.
*ONLY -- Generate help text only (without other HLLs).
YGENLMT
Specifies the maximum number of job list entries that can be processed by a single YGENSRC job. If a generation or compilation job is submitted which contains more entries (objects) than this value, the list will be automatically 'split' and processed by multiple YGENSRC jobs.
Note
: YGENLMT is shipped with a value of 99999. This value should not be changed unless directed by CA support.
1-99999
Note:
If an object assigned to a YGENSRC job is associated with another object assigned to another YGENSRC job, PGM and DSPF of an EDTFIL, for example, the YGENSRC job assigned to the PGM will also process the DSPF and update the job list accordingly. In this scenario the YGENSRC that was originally assigned the DSPF will not process that object. Therefore it is possible for one or more of the submitted YGENSRC jobs to not actually perform any source generation at all; this is expected behavior.
YHLLCBL
Specifies Cobol version.
*CBL85
*CBL74
YHLLGEN
Default HLL type to be given to new functions.
*RPG
*CBL
YNLLUPD
Sets the default for whether CHGOBJ functions update or release the database record if the record has not changed. This may be overridden with a matching function option.
*NO -- CHGOBJ functions always update the database whether the record changed or not.
*AFTREAD -- CHGOBJ checks whether to suppress database update after the After Data Read user point.
*YES -- CHGOBJ checks whether to suppress database update both after the After Data Read and after the Data Update user points.
YPKYLIB
Print file library name.
Valid System Name -- Specify your own.
*LIBL -- Will pick up name from your library list.
*NONE
YPKYVNM
Print file name for use on DSPF DDS PRINT keyword: specifies name of spool file for PRINT key output.
Valid System Name
*NONE
YPMTGEN
Device text prompt implementation which specifies whether the text on your device designs will be externalized to message files. The default is the value defined by the YSYSPMT model value.
*OFF -- This model is incapable of generating message IDs for screen text literals. (default
*MSGID -- This model will default to generated external message IDs for every screen text constant.
*LITERAL -- This model is capable of generating external message IDs but will not default to do so. You can override at the function level.
YPUTOVR
Specifies whether code is to be generated using PUTOVR option in DDS.
*YES -- Generate PUTOVR in the DDS.
*NO -- Do not generate PUTOVR in the DDS.
YRPGHSP
Specifies H specification line to be used for RPG programs.
H specification (80)
YRP4HSP
Specifies H Specification line to be used for RPGIV Programs (*PGM)
H Specification VNM(80)
YRP4HS2
Specifies H Specification line to be used for RPGIV Modules (*MOD)
H Specification VNM(80)
YRP4SGN
The options which are used to generate RPGIV (RPGLE) source in the model. See help text for more information
1st character - U,M,L
2nd character - G,W,R,B,P
YSCNLMT
Allows you to specify the scan limit for subfile functions. The shipped value is 500, but can be changed using YCHGMDLVAL. It can also be changed within a function through the use of the *PGM.*Scan limit value.
1- 999999999
YSHRSBR
indicates whether generated source code for subroutines is to be shared and whether the subroutine’s interface is internal or external.
*NO -- Generate source code each time the subroutine is called. The subroutine’s interface is internal.
*YES -- Share the first instance of generated source for all subsequent calls to the subroutine. The subroutine’s interface is external.
YSNDMSG
Specifies whether all messages are to be sent, or only the first one detected.
*YES
*NO
YSQLLCK
Specifies whether a row to be updated will be locked at the time it is read or at the time it is updated.
*UPD -- Lock row at time of update.
*FET -- If a SELECT is done, lock row at time of read; else lock row at time of update.
*IMG -- Lock row at time of read for CHGOBJ's embedded in the DBF record user point of standard Edit functions.
YSQLWHR
Specifies whether to use OR or NOT logic when generating SQL WHERE clauses.
*OR -- Use OR logic when generating SQL WHERE clauses.
*NOT -- Use NOT logic when generating SQL WHERE clauses.
YWSNGEN
Defines whether interactive functions are to operate on non-programmable terminals (NPT) or on programmable work stations (PWS) communicating with an IBM i host. For programmable workstations, you also specify the PC runtime environment.
*NPT -- Will generate for non-programmable terminals.
*GUI -- Generates for non-programmable terminals together with a Windows executable.
*JVA -- Generates for non-programmable terminals together with a Windows executable and a Java executable.
*VB -- Generates for non-programmable terminals together with a Visual Basic executable.
YW2ELIB
The name of the Web Option product library that is associated with this model if HTML templates are being generated
VNM (10) - Valid library name.
  • YRP4SGN
    RPGIV generation options: The options which are used to generate RPGIV (RPGLE) source in the model. This model value consists of 2 characters as follows:
    1st character:
    Case of generated source. This specifies the case of the actual source statements (excluding comments). It applies to variable names and RPGIV op-codes. The default is 'U' (upper-case). If any value other than those given below is specified, the default value will be used when generating RPGIV source.
    U
    Source code is generated in upper-case (e.g. 'NNNNNN')
    M
    Source code is generated in mixed-case (e.g. 'Nnnnnn')
    L
    Source code is generated in lower-case (e.g. 'nnnnnn')
    2nd character:
    Comment color in generated source. This specifies the color of any comments generated in the source. The default is 'G' (green). If any value other than those given below is specified, the default value is used when generating RPGIV source.
    G
    Comments are generated in green
    W
    Comments are generated in white
    R
    Comments are generated in red
    B
    Comments are generated in blue
    P
    Comments are generated in pink
  • YRP4HSP
    This model value controls characters 1-80 of data area YRP4HSPRFA.
  • YRP4HS2
    This model value controls characters 81-160 of data area YRP4HSPRFA 2 model values are used because in RPGIV, the H specification can be 160 characters.
Environment Values
Model Value
Description
Allowed Values
YACTUPD
Defines the default value for the change/create function option on the exit function definition panel.
*YES -- Option will always default to Y.
*NO -- Option will always default to N.
*CALC -- Option is set to Y only when a change to the function’s action diagram or panel design has been detected.
YCHGCTL
Name of the library in which the change control exit programs reside. Restricted exit programs will be called qualified by this library name. For more information on the change management facilities, please see the Start Change Control command (YSTRCHGCTL).
*NONE -- Restricted exit programs will not be called. Change control additional features are effectively off.
Valid library name.
YCMPCHG
Determines whether component change processing happens interactively and the access which developers have to the component change processing flag on their model.
*NONE -- No interactive component change processing occurs while editing model objects unless running the YAPYCMPCHG command.
*LIMITED -- Component change processing will occur if developer's model profile is set to Y. Only *DSNR authorized developers can change the model profile value.
*UNLIMITED -- Component change processing will occur if developer's model profile is set to Y. Developers may change the model profile value as they wish.
*GEN -- The YAPYCMPCHG command will be invoked for each object being generated by a YGENSRC job. This will keep the effect of changes to model objects as up to date as possible.
Note: *NONE and *GEN also imply *LIMITED authority to developer access to the component change processing flag on their model profile.
YCMPTXT
Text description of company using
CA 2E
. Used in banner of generated code.
It is displayed on the right-hand side and header/footer.
TEXT (30)
YCMTCDE
Determines whether commented-out (Inactive) code in the Action Diagram will be included when determining Object Usages and References
*YES - Inactive code is included.
*NO - Inactive code is not included
*IGN - there is no differentiation between active code and inactive code.
YCPYLIB
Name of library from which old physical file data is to be copied.
Valid System Name
*NONE
YCRTENV
Object creation environment: IBM i or System/38
QCL -- Create environment for S/38.
QCMD -- Create environment for IBM i.
YCRTJBD
Name of job description to use when submitting compilations. Default to QBATCH.
VNM (10) -- Valid job description name.
YDSTFIO
For SQL DRDA support, the distributed file I/O control option.
*SYNON -- Synon provides for control rolling between databases.
*USER -- User provides for control rolling between databases.
*NONE -- No distributed functionality is generated.
YEXCENV
Runtime environment: Specifies default initial value for execution environment for EXCMSG functions.
QCL -- Prepare execution for S/38.
QCMD -- Prepare execution for IBM i.
YGENLIB
Name of the generation library.
VNM (10) - Valid library name.
YGENRDB
For SQL DRDA support, the name of the default database. Used in the creation of the SQL package. This should typically correspond to the local database as defined in the IBM i RDB directory.
Valid database name.
YIGCCNV
Generate IGC (Kanji ideographic characters) support keywords in DDS.
0 -- Do not generate IGC support keywords
1 -- Generate IGC support keyword.
YLIBLST
Name of the model library list.
VNM (10) -- Valid library list name. Users are advised to ensure that the
CA 2E
Toolkit data object
YLIBLST is available in the library list of jobs running
CA 2E
commands.
YMDLLIB
Name of model library: must be the same as the library containing the model.
VNM (10) -- Valid library name.
YMDLLNG
National language for system portion of model.
Valid model language code; for example *ENG.
YMDLTXT
Text description of the model. Use in banner of generated code.
TEXT (30)
YOLDLIB
Name of library into which old physical files are archived.
Valid System Name
YOPNACC
Value defines whether concurrent access by *DSNR(s) and *PGMR(s) is allowed.
*YES -- Allow *DSNRs and *PGMRs in the model concurrently.
*NO -- Disallow concurrent *DSNR and *PGMR access.
YSQLLIB
Name of library in which to place the collection to implement the SQL database.
SQL Valid System name.
*NONE -- There is no SQL library associated with the model.
YTRGLIB
Specifies the name of the library into which model trigger references should be converted using the YCVTTRGDTA command.
*GENLIB, VNM(10)
YTRNAPI
Specifies the name of the API to be invoked at runtime by DSPFIL and SELRCD function types to convert non-key field filters to upper case values for comparison with subfile record field values.
VNM(8)
Help Generation Values
Model Value
Description
Allowed Values
YGENHLP
Determines whether help will be generated/created by default for functions in the model. This can be overridden by a function option. For Synon/TC the result depends on YGENGUI. See YGENHLP.
*YES -- Generate help text (UIM or TM) with all other HLLs.
*NO -- Do not generate help text.
*ONLY -- Generate help text only (without other HLLs).
YGUIHLP
Default GUI Help Language. Indicates the language generated for online help on programmable workstation functions; namely, if the YWSNGEN model value is set to *GUI, *VB, or *JVA. This can be overridden by a function option.
*NONE -- Do not generate GUI help.
*WIN -- Generate GUI help using Windows help.
*HTML -- Generate GUI help using HyperText Markup Language (HTML) for the Internet.
YHLPCSR
Specifies whether to generate cursor sensitive text.
*YES -- Generate help text that is cursor sensitive.
*NO -- Do not generate cursor sensitive help text.
YNPTHLP
Determines what type of help text will be generated by default for NPT functions in the model.
*UIM -- Generates help text in UIM (User Interface Manager) by default.
*TM -- Generates help text in TM (Text Management) by default.
Both are displayed using
CA 2E
utility.
YUIMBID
Tells the UIM generator whether to specify bi-directional support for UIM.
*NONE -- No bi-directional support for generated UIM panel groups.
*LTR -- Help is to be displayed with left-to-right orientation.
*RTL -- Help is to be displayed with right-to-left orientation.
YUIMFMT
Specifies the default formatting of narrative text, when included in generated UIM help.
*AUTO -- Format the narrative by default with a UIM Paragraph tag (:P).
*FIXED -- Format the narrative by default with a UIM Lines tag (:L).
YUIMIDX
Defines the valid name used for Help Search Index when generating UIM keywords in all DDS source for the model and when generating calls to
CA 2E
Display Help API displaying UIM help.
*NONE -- Do not generate any references to a search index.
*VLSPFX -- Use a name for the search index derived from the values list prefix.
YGENHLP
For Synon/TC applications, which source components get generated is determined by derivation of the YWSNGEN, YGENHLP, and YGENGUI model value as shown in this table:
Model Values
Source Components Generated
YWSNGEN
YGENHLP
YGENGUI
NPT HLL
NPT HELP
SDF
Windows Help
*NPT
*YES
n/a
yes
yes
---
---
*NO
yes
---
---
---
*ONLY
---
yes
---
---
*GUI
*YES
*YES
yes
yes
yes
yes
*NO
yes
yes
---
---
*ONLY
---
---
yes
yes
*NO
*YES
yes
---
yes
---
*NO
yes
---
---
---
*ONLY
---
---
yes
---
*ONLY
*YES
---
yes
---
yes
*NO
---
yes
---
---
*ONLY
---
yes
---
yes
PWS Environment Values
Model Value
Description
Allowed Values
YGUIAKY
Suppress Aid Keys. Specifies whether description of the keys should be displayed or not on the pull-down menu. Aid-keys are the command keys defined functionally rather than graphically on the screen.
*NO -- Do not suppress generation of aid-keys description on the pull-down menu; in other words, display aid keys.
*YES -- Suppress generation of aid-keys description.
YGUICMD
Command Key Descriptor Text. Indicates how command key text appears on your green-screen device designs. You can specify up to two ways. The default is F,CF as in F3=Exit and CF3=Exit.
*NONE -- No descriptor text is used.
text1,text2 -- Up to two ways in which command key text appears on your green-screen device designs, separated by a ‘,’; for example, ‘F,PF’, ‘,PF’. Each value may be up to five characters.
YGUIFLR
Application Folder for GUI. Name of the shared folder into which the Synon/TC source (SDF, SIF, ADF, MSF) is placed for processing on the PC. This must be a character string of up to six characters that follows the IBM i document path naming convention.
valid system name -- Name of shared folder. This name defaults to the name of the model.
*NONE -- There is no folder.
YGUILIB
Library Partitioning for GUI. Specifies the way in which SDF panels are partitioned into libraries within a Synon/TC application. There is a maximum of 1000 functions in a single library. Library names must be unique across all Synon/TC applications residing on the same PC. Names exceeding seven characters will be truncated.
valid library name -- A valid PC directory name. This will place all GUI functions into a single library.
*AUTO -- Library partitioning will be done automatically for each SDF panel using the shipped routine YALCLIBR1C. By default this builds the library name from the YGUIFLR value and the third character of the SDF name, allocating panels across libraries.
YGUILSO
Suppress List Options. Indicates whether subfile-select options should be displayed on the pull-down menu.
*NO -- Do not suppress display of subfile-select descriptions on the pull-down menu; in other words, display subfile-select descriptions.
*YES -- Suppress display of subfile-select descriptions.
YGUIOPR
Operator Between Prefix and Text. Indicates how a command key or subfile selector value is separated from the text that describes it on your green-screen device designs. The default is =, - as in F3=Exit and 5 - Display.
*NONE -- No operator is used.
text1,text2 -- Up to two ways in which a command key or subfile selector value is separated from the text that describes it on your green-screen device designs, separated by a comma; for example, ‘=,-’, ‘,--’. Each value may be up to two characters.
YGUISEL
Subfile Select Descriptor Text. Indicates how subfile selector text appears on your green-screen device designs. You can specify up to two ways. The default is Opt as in Opt1-Select.
*NONE -- No descriptor text is used.
text1,text2 -- Up to two ways in which subfile selector text appears on your green-screen device designs, separated by a comma; for example, ‘Opt,Sel’, ‘,Sel’. Each value may be up to five characters.
YGUITKY
Display command keys per tab. Indicates how command keys should be displayed on the non-NPT implementation of functions using tab dialogs; namely, Edit Record 2 and 3 and Display Record 2 and 3.
*NO -- Command keys are displayed once for the function, covering all tab dialogs. The command key text is taken from the first last detail screen.
*YES -- Command keys are displayed on each tab dialog. The command key text is taken from each detail screen.
System Defaults
Model Value
Description
Allowed Values
YSYSCHG
Gives the default YCHGCTL model value for new models.
*NONE -- Restricted exit programs are not called. Change control additional features are effectively off.
Valid library name.
YSYSDBF
Defines system database access method, either DDS and HLL or SQL Data Definition Language (DDL) and Data Manipulation Language (DML).
*DDS
*SQL
YSYSHLL
Default HLL given to new models. It is the value for YHLLGEN model value.
*RPG
*CBL
YSYSNPT
Gives the default YNPTHLP on YCRTMDLLIB.
*UIM -- Generates help text in UIM by default.
*TM -- Generates help text in TM by default.
YSYSPMT
Defines system prompts.
*OFF -- This model is incapable of generating message IDs for screen text literals.
*MSGID -- This model will default to generate external message IDs for every screen text constant.
*LITERAL -- This model is capable of generating external message IDs, but will not default to do so. You can override at a function level.
YSYSSAA
Defines system default for SAA formatting option YSAAFMT.
*CUAENTRY -- Defaults to a header/footer without windows or action bars.
*CUATEXT -- Defaults to windows and action bar style header/footers. All function types with the exception of SELRCD will default to action bars. The SELRCD will default to a window.
*S38 -- Defaults to System/38 style header/footer.
Unchangeable Model Values
The following two tables show model values which cannot be changed with YCHGMDLVAL.
Protected Model Values
Modern Values
To change and use this command
YMDLLIB
YRNMMDL
YMDLLVL
YAPYMDLCHG
YMDLNBR
YAPYSYSMDL
YMDLLNG
YAPYMDLTRN
YPMTNBR
YCRTMDLLIB
You can change the following system values using the i OS CHGDTAARA command. The name of the data area is the model value name with the suffix RFA; for example, the name of the null model for the system is contained in the YNLLMDLRFA data area in the
CA 2E
base product library.
Unchangeable System Model Values
Modern value
Set by
Role
YNLLMDL
Install procedure
Defines the name of the null model.
YSYSLNG
Install procedure
Defines the language of the installed product.
Example
To change the design standard to CUATEXT:
YCHGMDLVAL MDLVAL(YSAAFMT) + VALUE(*CUATEXT)