CA 2E

Command Reference Guide

r8.5

This documentation and any related computer software help programs (hereinafter referred to as the Documentation) is for the end users informational purposes only and is subject to change or withdrawal by CA at any time. This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, without the prior written consent of CA. This Documentation is confidential and proprietary information of CA and protected by the copyright laws of the United States and international treaties. Notwithstanding the foregoing, licensed users may print a reasonable number of copies of the documentation for their own internal use, and may make one copy of the related software as reasonably required for back-up and disaster recovery purposes, provided that all CA copyright notices and legends are affixed to each reproduced copy. Only authorized employees, consultants, or agents of the user who are bound by the provisions of the license for the product are permitted to have access to such copies. The right to print copies of the documentation and to make a copy of the related software is limited to the period during which the applicable license for the Product remains in full force and effect. Should the license terminate for any reason, it shall be the users responsibility to certify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed. EXCEPT AS OTHERWISE STATED IN THE APPLICABLE LICENSE AGREEMENT, TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION AS IS WITHOUT WARRANTY OF ANY KIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO THE END USER OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE, DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED OF SUCH LOSS OR DAMAGE. The use of any product referenced in the Documentation is governed by the end users applicable license agreement. The manufacturer of this Documentation is CA. Provided with Restricted Rights. Use, duplication or disclosure by the United States Government is subject to the restrictions set forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.2277014(b)(3), as applicable, or their successors. All trademarks, trade names, service marks, and logos referenced herein belong to their respective companies. Copyright 2009 CA. All rights reserved.

Contact CA
Contact Technical Support For your convenience, CA provides one site where you can access the information you need for your Home Office, Small Business, and Enterprise CA products. At http://ca.com/support, you can access the following:

Online and telephone contact information for technical assistance and customer services Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your product

Provide Feedback If you have comments or questions about CA product documentation, you can send a message to [email protected]. If you would like to provide feedback about CA product documentation, complete our short customer survey, which is also available on the CA support website, found at http://ca.com/support.

Contents
Chapter 1: Introduction
Purpose ...................................................................................... 1-1 Organization ................................................................................. 1-1 Contents ..................................................................................... 1-1 Acronyms Used in this Module ................................................................. 1-2 Contacting Customer Support ................................................................. 1-2

Chapter 2: Executing Commands

Executing a CA 2E Command .................................................................. 2-1 Interactively .............................................................................. 2-1 In Batch.................................................................................. 2-1 Determining a Commands Running Environment ............................................... 2-2

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

YADDMDLLE (Add a Model List Entry) Command ................................................ 3-1 Required ................................................................................. 3-1 Optional .................................................................................. 3-2 Parameters ............................................................................... 3-2 Notes .................................................................................... 3-4 Example ................................................................................. 3-4 YAPYCMPCHG (Apply Component Changes) Command .......................................... 3-5 Required ................................................................................. 3-5 Parameters ............................................................................... 3-5 Notes .................................................................................... 3-6 Example ................................................................................. 3-6 YAPYMDLCHG (Apply Model Changes) Command................................................ 3-6 Parameters ............................................................................... 3-7 Notes .................................................................................... 3-7 Example ................................................................................. 3-8 YAPYSYSMDL (Apply System Model Data) Command ............................................ 3-8 Parameters ............................................................................... 3-8 Notes .................................................................................... 3-9 Example ................................................................................. 3-9 YAPYTRNMDL (Apply Translation to Model) Command ........................................... 3-9

Contents

Parameters .............................................................................. 3-9 Notes ................................................................................... 3-10 Example ................................................................................ 3-11 YBLDJOBLST (Build Job List) Command ....................................................... 3-11 Parameters ............................................................................. 3-12 Notes ................................................................................... 3-15 Example ................................................................................ 3-16 YBLDMDLLST (Build a Model Object List) Command ........................................... 3-16 Parameters ............................................................................. 3-17 Notes ................................................................................... 3-20 Example ................................................................................ 3-20 YCHGMDLLE (Change a Model Object List Entry) Command .................................... 3-21 Required ................................................................................ 3-21 Optional ................................................................................ 3-21 Parameters ............................................................................. 3-21 Notes ................................................................................... 3-22 Example ................................................................................ 3-23 YCHGMDLOBJ (Change Model Object) Command .............................................. 3-23 Required ................................................................................ 3-23 Optional ................................................................................ 3-24 Parameters ............................................................................. 3-24 Example ................................................................................ 3-29 YCHGMDLOD (Change Model Object Description) Command.................................... 3-29 Required ................................................................................ 3-30 Parameters ............................................................................. 3-30 Notes ................................................................................... 3-31 Example ................................................................................ 3-32 YCHGMDLPRF (Change Model Profile) Command .............................................. 3-32 Required ................................................................................ 3-32 Optional ................................................................................ 3-33 Parameters ............................................................................. 3-35 Notes ................................................................................... 3-40 Example ................................................................................ 3-41 YCHGMDLVAL (Change Model Value) Command ............................................... 3-41 Required ................................................................................ 3-41 Parameters ............................................................................. 3-41 Notes ................................................................................... 3-41 Model Values in Alphabetical Order ....................................................... 3-42 Model Values Grouped By Role ........................................................... 3-45 YACTSYM ............................................................................... 3-48 YCUAPMT ............................................................................... 3-48 YLHSFLL ................................................................................ 3-50 YWBDCHR .............................................................................. 3-50

vi

Command Reference Guide

YGENHLP ................................................................................ 3-64 Unchangeable Model Values .............................................................. 3-68 YCHKDTAMDL (Check Data Model) Command.................................................. 3-68 Parameters .............................................................................. 3-69 Example ................................................................................ 3-69 YCHKFUNACT (Check Function Action Diagram) Command ..................................... 3-69 Required ................................................................................ 3-70 Parameters .............................................................................. 3-70 Example ................................................................................ 3-71 YCHKJOBLE (Check Job List Entries) Command ................................................ 3-71 Parameters .............................................................................. 3-72 Notes ................................................................................... 3-74 Example ................................................................................ 3-74 YCHKMDL (Check Model) Command........................................................... 3-74 Parameters .............................................................................. 3-75 Example ................................................................................ 3-77 YCHKMDLLST (Check a Model Object List) Command........................................... 3-78 Optional ................................................................................. 3-79 Parameters .............................................................................. 3-81 Notes ................................................................................... 3-84 Example ................................................................................ 3-85 YCHKMDLOBJ (Check Existence of Model Object) Command .................................... 3-85 Required ................................................................................ 3-86 Parameters .............................................................................. 3-86 Notes ................................................................................... 3-88 Example ................................................................................ 3-88

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

YCLRMDL (Clear Model) Command ............................................................. 4-1 Required ................................................................................. 4-1 Optional .................................................................................. 4-1 Parameters ............................................................................... 4-1 Notes .................................................................................... 4-2 Example ................................................................................. 4-2 YCLRMDLLST (Clear a Model Object List) Command ............................................. 4-2 Optional .................................................................................. 4-3 Parameters ............................................................................... 4-3 Example ................................................................................. 4-3 YCMPMDLOBJ (Compare Model Objects) Command ............................................. 4-4 Required ................................................................................. 4-4 Optional .................................................................................. 4-5

Contents

vii

Parameters .............................................................................. 4-5 Notes .................................................................................... 4-8 Example ................................................................................. 4-8 YCPYMDL (Copy Model) Command ............................................................ 4-9 Required ................................................................................. 4-9 Optional ................................................................................. 4-9 Parameters .............................................................................. 4-9 Notes ................................................................................... 4-10 Example ................................................................................ 4-11 YCPYMDLLST (Copy Model Object List) Command ............................................. 4-11 Required ................................................................................ 4-11 Optional ................................................................................ 4-12 Parameters ............................................................................. 4-12 Notes ................................................................................... 4-13 Example ................................................................................ 4-14 YCPYMDLOBJ (Copy Model Objects) Command ................................................ 4-14 Required ................................................................................ 4-15 Optional ................................................................................ 4-16 Parameters ............................................................................. 4-16 Notes ................................................................................... 4-22 Example ................................................................................ 4-29 YCRTGENOBJ (Create Generation Objects) Command .......................................... 4-30 Optional ................................................................................ 4-30 Parameters ............................................................................. 4-30 Notes ................................................................................... 4-32 Example ................................................................................ 4-32 YCRTJOBLE (Create Job List Entry) Command ................................................. 4-33 Required ................................................................................ 4-33 Optional ................................................................................ 4-33 Parameters ............................................................................. 4-33 Notes ................................................................................... 4-35 Example ................................................................................ 4-35 YCRTMDLLIB (Create Model Library) Command ............................................... 4-35 Parameters ............................................................................. 4-38 Notes ................................................................................... 4-44 Example ................................................................................ 4-47 YCRTMDLVSN (Create Model Version) Command .............................................. 4-47 Parameters ............................................................................. 4-48 Notes ................................................................................... 4-50 Example ................................................................................ 4-51 YCRTOBJVSN (Create Object Version) Command .............................................. 4-51 Required ................................................................................ 4-51 Optional ................................................................................ 4-51

viii

Command Reference Guide

Parameters .............................................................................. 4-51 Example ................................................................................ 4-52 YCRTSQLLIB (Create SQL Library) Command .................................................. 4-52 Required ................................................................................ 4-52 Optional ................................................................................. 4-53 Parameters .............................................................................. 4-53 Notes ................................................................................... 4-54 Example ................................................................................ 4-54 YCVTCNDVAL (Convert Condition Values) Command........................................... 4-54 Optional ................................................................................. 4-55 Parameters .............................................................................. 4-55 Notes ................................................................................... 4-56 Example ................................................................................ 4-57 YCVTDSTFIL (Convert Distributed Files) Command ............................................. 4-57 Optional ................................................................................. 4-57 Parameters .............................................................................. 4-57 Notes ................................................................................... 4-58 Example ................................................................................ 4-58 YCVTJOBLST (Convert a Job List to CA 2E Toolkit Object List) Command ........................ 4-59 Optional ................................................................................. 4-59 Parameters .............................................................................. 4-59 Notes ................................................................................... 4-61 Example ................................................................................ 4-61 YCVTMDLLST (Convert Model List to Job List) Command ....................................... 4-61 Optional ................................................................................. 4-62 Parameters .............................................................................. 4-62 Notes ................................................................................... 4-65 Example ................................................................................ 4-66 YCVTMDLMSG (Convert Model Messages) Command ........................................... 4-66 Optional ................................................................................. 4-66 Parameters .............................................................................. 4-66 Notes ................................................................................... 4-67 Example ................................................................................ 4-68 YCVTMDLPNL (Convert Model Panel Designs) Command ........................................ 4-68 Optional ................................................................................. 4-69 Parameters .............................................................................. 4-69 Notes ................................................................................... 4-71 Example ................................................................................ 4-72 YCVTMDLVNM (Convert Model Names) Command .............................................. 4-72 Required ................................................................................ 4-72 Parameters .............................................................................. 4-72 Notes ................................................................................... 4-72 Example ................................................................................ 4-73

Contents

ix

YCVTTMUIM (Convert Help Text to UIM Panel) Command ...................................... 4-73 Required ................................................................................ 4-74 Parameters ............................................................................. 4-74 Notes ................................................................................... 4-76 Example ................................................................................ 4-76 YDLTMDLLE (Delete a Model Object List Entry) Command ...................................... 4-76 Required ................................................................................ 4-77 Optional ................................................................................ 4-77 Parameters ............................................................................. 4-77 Note .................................................................................... 4-78 Example ................................................................................ 4-78 YDLTMDLLST (Delete a Model Object List) Command .......................................... 4-78 Required ................................................................................ 4-78 Parameters ............................................................................. 4-78 Notes ................................................................................... 4-79 Example ................................................................................ 4-79 YDLTMDLVSN (Delete Model Version) Command .............................................. 4-79 Required ................................................................................ 4-80 Optional ................................................................................ 4-80 Parameters ............................................................................. 4-80 Notes ................................................................................... 4-83 Example ................................................................................ 4-83 YDLTOBJTBL (Delete Object Table User Space) ................................................ 4-84 Parameters ............................................................................. 4-84

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

YDOCMDLACP (Document Model Access Paths) Command ...................................... 5-1 Optional ................................................................................. 5-1 Parameters .............................................................................. 5-1 Notes .................................................................................... 5-3 Example ................................................................................. 5-3 YDOCMDLAPP (Document Model Application Areas) Command .................................. 5-3 Optional ................................................................................. 5-3 Parameters .............................................................................. 5-3 Notes .................................................................................... 5-5 Example ................................................................................. 5-5 YDOCMDLF (Document Model Files) Command ................................................. 5-5 Optional ................................................................................. 5-5 Parameters .............................................................................. 5-5 Notes .................................................................................... 5-7 Example ................................................................................. 5-7

Command Reference Guide

YDOCMDLFLD (Document Model Fields) Command .............................................. 5-7 Parameters ............................................................................... 5-7 Notes .................................................................................... 5-8 Example ................................................................................. 5-8 YDOCMDLFUN (Document Model Functions) Command .......................................... 5-8 Optional .................................................................................. 5-9 Parameters .............................................................................. 5-10 Notes ................................................................................... 5-14 Example ................................................................................ 5-15 YDOCMDLLST (Document a Model Object List) Command ...................................... 5-15 Required ................................................................................ 5-16 Parameters .............................................................................. 5-16 Notes ................................................................................... 5-17 Example ................................................................................ 5-17 YDOCMDLMSG (Document Model Messages) Command ........................................ 5-18 Parameters .............................................................................. 5-18 Notes ................................................................................... 5-19 Example ................................................................................ 5-19 YDOCMDLREL (Document Model Relations) Command .......................................... 5-19 Optional ................................................................................. 5-19 Parameters .............................................................................. 5-19 Notes ................................................................................... 5-21 Example ................................................................................ 5-21 YDOCURF (Document Unreferenced Objects) Command ........................................ 5-21 Parameters .............................................................................. 5-22 Example ................................................................................ 5-23 YDSPJOBLST (Display a Job List) Command ................................................... 5-23 Optional ................................................................................. 5-24 Parameters .............................................................................. 5-24 Notes ................................................................................... 5-25 Example ................................................................................ 5-25 YDSPMDLLST (Display a Model Object List) Command.......................................... 5-25 Optional ................................................................................. 5-26 Parameters .............................................................................. 5-26 Notes ................................................................................... 5-27 Example ................................................................................ 5-27 YDSPMDLOD (Display Model Object Description) Command ..................................... 5-27 Required ................................................................................ 5-28 Parameters .............................................................................. 5-28 Notes ................................................................................... 5-29 Example ................................................................................ 5-30 YDSPMDLREF (Display Model References) Command ........................................... 5-30 Parameters .............................................................................. 5-33

Contents

xi

Notes ................................................................................... 5-37 Reference Table ......................................................................... 5-38 Example ................................................................................ 5-41 YDSPMDLUSG (Display Model Usages) Command.............................................. 5-41 Optional ................................................................................ 5-41 Parameters ............................................................................. 5-43 Notes ................................................................................... 5-47 Usage Table............................................................................. 5-48 Example ................................................................................ 5-51 YDSPMDLVAL (Display Model Value) Command................................................ 5-52 Optional ................................................................................ 5-52 Parameters ............................................................................. 5-52 Example ................................................................................ 5-53 YDUPAPPOBJ (Duplicate Application Objects) Command ....................................... 5-53 Optional ................................................................................ 5-53 Parameters ............................................................................. 5-53 Notes ................................................................................... 5-54 YEDTCPYLST (Edit Model Object List for Copy) Command ...................................... 5-55 Optional ................................................................................ 5-55 Parameters ............................................................................. 5-55 Notes ................................................................................... 5-56 Example ................................................................................ 5-56 YEDTDFTATR (Edit Default Display Attributes) Command ...................................... 5-56 Optional ................................................................................ 5-56 Parameters ............................................................................. 5-56 Notes ................................................................................... 5-57 Example ................................................................................ 5-57 YEDTMDL (Edit Model) Command ............................................................ 5-57 Short Form ............................................................................. 5-57 Long Form .............................................................................. 5-58 Parameters ............................................................................. 5-58 Notes ................................................................................... 5-61 Examples ............................................................................... 5-61 YEDTMDLLST (Edit Model Object List) Command .............................................. 5-62 Optional ................................................................................ 5-62 Parameters ............................................................................. 5-62 Notes ................................................................................... 5-65 Example ................................................................................ 5-65 YEDTMDLPRF (Edit Model Profile) Command .................................................. 5-65 Required ................................................................................ 5-66 Parameters ............................................................................. 5-66 Notes ................................................................................... 5-66 Example ................................................................................ 5-66

xii

Command Reference Guide

YEDTNXTMNC (Edit Next Mnemonics) Command ............................................... 5-66 Required ................................................................................ 5-67 Parameters .............................................................................. 5-67 Example ................................................................................ 5-67 YEXCMDLLST (Execute a Model Object List) Command ......................................... 5-67 Required ................................................................................ 5-68 Parameters .............................................................................. 5-68 Notes ................................................................................... 5-72 Example ................................................................................ 5-72 YEXCSQL (Execute SQL Statements) Command................................................ 5-73 Required ................................................................................ 5-73 Optional ................................................................................. 5-73 Parameters .............................................................................. 5-73 Example ................................................................................ 5-74 YFLTMDLLST (Filter a Model Object List) Command ............................................ 5-74 Required ................................................................................ 5-77 Optional ................................................................................. 5-78 Parameters .............................................................................. 5-81 Notes ................................................................................... 5-90 Examples ............................................................................... 5-91 YINXMDLLST (Index a Model List) Command .................................................. 5-91 Parameters .............................................................................. 5-92 Notes ................................................................................... 5-93 Example ................................................................................ 5-93 YOPRMDLLST (Operate on a Model Object List) Command ...................................... 5-93 Required ................................................................................ 5-94 Optional ................................................................................. 5-95 Parameters .............................................................................. 5-95 Notes ................................................................................... 5-97 Examples ............................................................................... 5-98

Chapter 6: Commands (YRDRMDLOBJ - Y2CALL)

YRDRMDLOBJ (Redirect Model Object) Command ............................................... 6-1 Required ................................................................................. 6-5 Parameters ............................................................................... 6-5 Notes .................................................................................... 6-7 Example ................................................................................. 6-9 YRGZMDL (Reorganize Model) Command ....................................................... 6-9 Required ................................................................................. 6-9 Parameters ............................................................................... 6-9 Notes ................................................................................... 6-10

Contents

xiii

Example ................................................................................ 6-10 YRNMMDL (Rename Model) Command ........................................................ 6-10 Required ................................................................................ 6-10 Optional ................................................................................ 6-11 Parameters ............................................................................. 6-11 Notes ................................................................................... 6-13 Example ................................................................................ 6-14 YRTVMDLOBJ (Retrieve Object Description) Command ......................................... 6-14 Required ................................................................................ 6-14 Optional ................................................................................ 6-15 Parameters ............................................................................. 6-15 Notes ................................................................................... 6-22 Example ................................................................................ 6-22 YRTVMDLPRF (Retrieve Model Profile details) Command ....................................... 6-23 Required ................................................................................ 6-23 Optional ................................................................................ 6-23 Parameters ............................................................................. 6-23 Notes ................................................................................... 6-27 Example ................................................................................ 6-27 YRTVMDLVAL (Retrieve Model Value) Command ............................................... 6-27 Required ................................................................................ 6-27 Parameters ............................................................................. 6-27 Notes ................................................................................... 6-28 Example ................................................................................ 6-28 YRTVPFMDL (Retrieve Physical Files Into Model) Command .................................... 6-28 Required ................................................................................ 6-29 Optional ................................................................................ 6-29 Parameters ............................................................................. 6-29 Notes ................................................................................... 6-30 Example ................................................................................ 6-32 YSBMMDLCRT (Submit Create Requests from Model) Command ................................ 6-34 Optional ................................................................................ 6-35 Parameters ............................................................................. 6-37 Notes ................................................................................... 6-42 Example ................................................................................ 6-43 YSETCPYNME (Set Model Object Copy Name) Command ....................................... 6-44 Notes ................................................................................... 6-44 Example ................................................................................ 6-44 YSLTVSN (Select Version) Command ......................................................... 6-45 Required ................................................................................ 6-45 Optional ................................................................................ 6-45 Parameters ............................................................................. 6-45 Example ................................................................................ 6-46

xiv

Command Reference Guide

YSNCMDL (Synchronize Model) Command ..................................................... 6-46 Required ................................................................................ 6-46 Parameters .............................................................................. 6-46 Notes ................................................................................... 6-47 Example ................................................................................ 6-47 YSTRCHGCTL (Start Change Control) Command ............................................... 6-47 Required ................................................................................ 6-47 Parameters .............................................................................. 6-48 Notes ................................................................................... 6-49 Example ................................................................................ 6-49 YSTRY2 (Start CA 2E) Command ............................................................. 6-50 Optional ................................................................................. 6-50 Parameters .............................................................................. 6-50 Notes ................................................................................... 6-51 Example ................................................................................ 6-51 YWRKDSTFIL (Work Distributed Files) Command .............................................. 6-51 Optional ................................................................................. 6-52 Parameters .............................................................................. 6-52 Notes ................................................................................... 6-52 Example ................................................................................ 6-52 YWRKMDLLST (Work with Model Object Lists) Command ....................................... 6-53 Required ................................................................................ 6-53 Parameters .............................................................................. 6-53 Notes ................................................................................... 6-54 Example ................................................................................ 6-54 Y2 (Edit Model) Command.................................................................... 6-54 Optional ................................................................................. 6-55 Parameters .............................................................................. 6-55 Notes ................................................................................... 6-58 Examples ............................................................................... 6-58 Y2CALL (Call a Program) Command ........................................................... 6-59 Required ................................................................................ 6-59 Optional ................................................................................. 6-59 Parameters .............................................................................. 6-59 Notes ................................................................................... 6-61 Example ................................................................................ 6-62

Appendix A: Commands Grouped by Functional Area

Upgrade Commands .......................................................................... A-1 Model Setup Commands ...................................................................... A-1 Model Objects Commands ..................................................................... A-2

Contents

xv

Edit Commands .............................................................................. A-2 Create Application Commands ................................................................ A-2 Model Object Lists Commands ................................................................ A-3 Document Commands ........................................................................ A-3 Copy Commands ............................................................................. A-4 Miscellaneous Commands ..................................................................... A-4

Index

xvi

Command Reference Guide

Chapter 1: Introduction
This preface introduces the Command Reference Guide. It provides you with information on how the module is organized, identifies the contents, and lists the established conventions. Command Reference is part of a documentation set that provide instructions on how to use the CA 2E product (formerly known as Advantage 2E).

Purpose
This reference module describes CA 2E commands. The next chapter tells you how to execute a CA 2E command.

Organization
The information in this guide is organized for quick and easy access. All CA 2E commands are listed in alphabetical order. Each command is documented according to the i OS convention.

Contents
The Command Reference module includes an introductory chapter telling you how to execute a CA 2E command, the commands listed in alphabetical order, and an appendix grouping the commands by functional area. For each command there is:

A summary of the function of the command. A command diagram. A description of each parameter and allowed values for the command. A list of notes regarding any restrictions or extra considerations. An example or examples using the command.

Chapter 1: Introduction

11

Acronyms Used in this Module

Acronyms Used in this Module

Descriptions of the acronyms used in this module are defined once, in this chapter. Thereafter, only the acronym is used.

(TH9)API (TH9)CL (TH9)DRDA (TH9)HLL (TH9)NPT (TH9)PWS (TH9)RDB (TH9)SQL (TH9)UIM (TH9)VNM

Application Program Interface control language Distributed Relational Database Architecture high level language non-programmable terminal programmable work station relational database Structured Query Language User Interface Manager valid name

Contacting Customer Support

For online technical assistance and a complete list of locations, primary service hours, and telephone numbers, contact Technical Support at http://ca.com/support. For telephone assistance, call: U.S. and Canada 1-800-645-3042 International (1) 631-342-4683

12

Command Reference Guide

Chapter 2: Executing Commands

This chapter describes how to execute a CA 2E command and how to determine which running environment is valid for each command. The following instructions provide information for executing a command interactively or submitting the command to batch.

Executing a CA 2E Command
You can execute CA 2E commands interactively or in batch.

Interactively
To execute a command interactively: 1. 2. At an i OS command line, enter the command and press F4 to prompt. The command prompt entry displays If there are additional parameters available for the command, the function key F10 appears at the bottom of your panel. Press F10 to use the additional values. You will occasionally be prompted for additional parameters if there is a dependency on values you enter. If you are unsure of what value to enter in a field, enter F4 or ? to prompt for the allowed values of the field. Alternatively, you can press help to obtain online Help for the field. Select the appropriate value. You will return to the previous panel with the value entered. Press Enter when you are satisfied with the values you have entered. The command will now execute.

3.

4. 5.

In Batch
To submit a command to batch: At the command prompt, enter SBMJOB and press F4. Enter the command in the Command to run (CMD) parameter. Then follow the above instructions, steps 2 through 4. Press Enter on the SBMJOB panel to submit your job to batch.

Chapter 2: Executing Commands

21

Determining a Commands Running Environment

Determining a Commands Running Environment

A box in the lower right corner of each command diagram contains an entry code that indicates the environment in which the command can be run. The entry code contains the following symbols:

JobIndicates that the command can be run independently as a separate function, in other words, outside a compiled CL program. PgmIndicates that the command can be included in a compiled CL program. BIndicates that the command can be run in batch. IIndicates that the command can be run interactively.

The following table shows the possible combinations and their meanings.

Code Job: B Job: I Job: B,I

Meaning The command can be run in batch as a separate function. The command can be run interactively as a separate function. The command can be run either in batch or interactively as a separate function. The command can be run as part of a compiled CL program that is called in batch. The command can be run as part of a compiled CL program that is called interactively. The command can be run as part of a compiled CL program that is called either in batch or interactively.

Pgm: B

Pgm: I

Pgm: B,I

22

Command Reference Guide

Chapter 3: Commands (YADDMDLLE YCHKMDLOBJ)

This chapter contains details for CA 2E commands YADDMDLLE through YCHKMDLOBJ. These commands appear in alphabetical order and include descriptions of their functions, parameters and allowed values, notes, and examples. Each command is also accompanied by a command diagram.

YADDMDLLE (Add a Model List Entry) Command

This command allows a user to add a single model object list entry. The list may or may not exist. If it does not exist, it is created by this command.

Required
*OBJSGT *SELECT *ACP *NONE YADDMDLLE OBJNAM *ARRAYS *MESSAGES object name owner name *FLD *FIL *FUN *MSG *ARR *CND *APP

*OBJNAM OBJSGT object surrogate

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

31

YADDMDLLE (Add a Model List Entry) Command

Optional
*MDLPRF *MDLLIB/ *USER MDLLST *SELECT model library list name *SAME OUTFLAGVAL *NONE *SELECTED

*SAME OUTCPYOBJ *NONE *SELECTED

CA 2E Modules: *ALL

Job: L,B Pgm: L,B

Parameters
The following are parameters for the YADDMDLLE command.

OBJNAM
The object name to be added. This parameter consists of three elements which together identify a model object. Values for this parameter are described in the following:

*OBJSGT(default) Single value indicating that the object surrogate is used to identify the model object to be added. *SELECTSingle value indicating that the object to be added is selected using an interactive display function. object owner nameThe character name of the object that owns the object to be added. Thus, for a function, the owning file would be entered. *ARRAYSSpecial value for the product internal file *ARRAYS. *MESSAGESSpecial value for the product internal file *MESSAGES. object nameThe character name of the object to be added. object typeThe object type of the object. *ACPObject is of type access path. *APPObject is of type application area. *ARRObject is of type array. *CNDObject is of type condition.

32

Command Reference Guide

YADDMDLLE (Add a Model List Entry) Command

*FILObject is of type file. *FLDObject is of type field. *FUNObject is of type function. *MSGObject is of type message.

OBJSGT
Unique number identifier of the model object that is added. Values for this parameter are described in the following:

*OBJNAM(default) Use object name to identify the model object to be added. object surrogateThe surrogate number of the model object.

MDLLST
The qualified name of the model object list to which the entry is added. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe name of the list to be added. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used. library nameThe name of the model library.

OUTFLAGVAL
This parameter specifies the initial value to be placed in the object selected flag associated with each list entry. Values for this parameter are described in the following:

*SAME(default) No flag value is to be used. New entries are written with the flag indicating that the entry is not selected. There is no change to the selection status of existing entries. *NONENew and existing entries are flagged as not selected. *SELECTEDNew and existing entries are flagged as selected. This flag can be used by other list commands when selecting list entries.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

33

YADDMDLLE (Add a Model List Entry) Command

OUTCPYOBJ
This parameter specifies the initial value to be placed in the copy object flag associated with each list entry. This flag is used by the Copy Model Object Command (YCPYMDLOBJ) when selecting objects to copy to a target model. Values for this parameter are described in the following:

*SAME (default) No flag value is to be used. New entries are written with the flag indicating that the entry is not selected. There is no change to the selection status of existing entries. *NONENew and existing entries are flagged as not selected. *SELECTEDNew and existing entries are flagged as selected.

Notes

A value other than *MDLLIB for MDLLST can result in the library list being changed during execution of this command. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. Model objects can either be identified by object name (OBJNAM) or by object surrogate key number (OBJSGT). If the OBJNAM parameter is used, the processing program must convert to surrogate key number internally. Thus, it will normally be more efficient to use the surrogate number if this value is available. The surrogate number for an object can be obtained using the Retrieve Model Object command (YRTVMDLOBJ). The object to be added to the target list must exist in the model.

Example
To add the Display Product Details function to model object list WRKLST, and to have the new entry flagged as selected:
YADDMDLLE OBJNAM('Product' 'Display Product + Details' *FUN) MDLLST(*MDLLIB/WRKLST) + OUTFLAGVAL(*SELECTED)

34

Command Reference Guide

YAPYCMPCHG (Apply Component Changes) Command

YAPYCMPCHG (Apply Component Changes) Command

Component change processing is the process by which a change to a particular object is reflected in the model by the propagation of that change throughout the users of the changed object. The object that is changed can be a component of many other objects in the model, and this process attempts to make the repercussions visible. This command can be used to invoke this process in batch for all changed objects which were not processed interactively.

Required
*MDLLIB YAPCMPCHG MDLLIB *CURLIB model lib name CA 2E Modules: *ALL Job: B Pgm: L,B

Parameters
The following are parameters for the YAPYCMPCHG command.

MDLLIB
The name of the model library in which component changes are applied. Values for this parameter are described in the following:

*MDLLIB(default) Special value meaning that the model library is the first model found in the current job's library list. *CURLIBSpecial value meaning that the model library is the current library for the job. model library nameThe name of the model.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

35

YAPYMDLCHG (Apply Model Changes) Command

Notes

Processing involves the examination of all objects in the model that have been changed but that have not had component change processing applied. The using objects of each of these objects are expanded and the change type associated with the changed object is propagated throughout them. The changed object is then updated to show that component change processing has been applied. Processing includes a call to an exit program for each using object encountered. The details of the call are as follows:
Program Interface : : YCMPCHGR1C Return code Original surrogate Object surrogate Change type : : : : 7 7 7 3 characters decimals decimals characters (GEN or EDT)

Developers can use the program to include any additional processing they desire. For example, it can be used to update an external database tracking changes in the model, or to place an entry onto a model list for later resolution of the component change that has happened to a given object. Additional information is included in the source for the exit program which is shipped in file QCLSRC in library Y2SYSRC.

Example
To apply component changes in the model library that is the highest model in the current library list:
YAPYCMPCHG MDLLIB( *MDLLIB )

YAPYMDLCHG (Apply Model Changes) Command

Upgrades a design model or models with any changes required by a new release of CA 2E. New releases of CA 2E can include modifications that must be applied to each design model before the new release of CA 2E can be used with that model. This command applies any such changes to a named model.

36

Command Reference Guide

YAPYMDLCHG (Apply Model Changes) Command

Required
lib name YAPYMDLCHG MDLLIB generic* lib name *CURLIB CA 2E Modules: *ALL *ALL Job: L,B Pgm: L,B

Parameters
The following are parameters for the YAPYMDLCHG command.

MDLLIB
Name of library containing a design model to which the changes are applied. A generic name is allowed; for example, AB*. Values for this parameter are described in the following:

*ALLAll models on the machine are upgraded. (Models which have already been upgraded are ignored). *CURLIBUse current library for invoking job.

Notes

You should make a backup of the design model before running this command. You must have object existence rights to the model to be able to run this command; that is, to all the objects in the model library. The current release level of the design model is indicated by a data area YMDLLVLRFA, a copy of which resides in each model library. You can see the value on the model values display. The current release level of the design model expected by CA 2E is indicated by a data area YMDLLVLSYA in the product library. You can see the value on the system parameter display. The YAPYMDLCHG command is generally cumulative. See your installation instructions regarding any restrictions. If you have an old model that you have archived to cartridge or tape and then restored, you can use the YAPYMDLCHG command to bring the model up to date. The YAPYMDLCHG command invokes the command Apply System Data to Model (YAPYSYSMDL) if necessary. Once a model has been upgraded to a new level using the YAPYMDLCHG command, it cannot be converted downwards again.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

37

YAPYSYSMDL (Apply System Model Data) Command

If this command fails, you should resolve the problem with your product support representative, then restore the backup copy of your model from tape and start again. If all of the prior level files are not deleted by YAPYMDLCHG, an error message is issued at the end of the conversion. These files will have been renamed to start with Z. The usual cause of this problem is user logical files that are built over design model physical files. The model is properly converted, but you must manually delete these Z files.

Example
To update the model MYMDL:
YAPYMDLCHG MDLLIB(MYMDL)

YAPYSYSMDL (Apply System Model Data) Command

Updates the system data part of a CA 2E model. Each design model contains, apart from user-defined objects, a number of the shipped system objects, such as standard program functions and default message functions. From time to time updates are issued to the system objects. This command is for applying the updates to your own models. Required
library name YAPYSYSMDL MDLLIB *CURLIB

CA 2E Modules: *ALL

Job: L,B Pgm: L,B

Parameters
The following are parameters for the YAPYSYSMDL command.

MDLLIB
Name of library containing a design model. The system object part of this model is to be updated. The value for this parameter is described in the following:

*CURLIBUse current library for invoking job.

38

Command Reference Guide

YAPYTRNMDL (Apply Translation to Model) Command

Notes

The current release level of the system objects in a model is indicated by a data area YMDLNBRRFA, a copy of which resides in each model library. You can see the current value on the model values display. The current release level of the system objects required by CA 2E is indicated by the data area YMDLNBRSYA in the product library. The current value can be seen on the model values display. You automatically invoke this command by using the command Apply Model Changes (YAPYMDLCHG)

Example
To update the system objects in model MYMDL:
YAPYSYSMDL MDLLIB(MYMDL)

YAPYTRNMDL (Apply Translation to Model) Command

Transposes data from a national language library into the system portion of a design model. This command translates the data in the CA 2E shipped files that are created by the Create Model Library command (YCRTMDLLIB), such as *Standard header/footer, *Built-in functions and *Program data. Required
library name YAPYSYSMDL MDLLIB *CURLIB

LNG

One of the following: *DAN *DTC *ELL *ENG *ESP *FIN *FRN *HRZ *ITA *JPN *NDL *NSK *PTG *SLO *SVK *UCS

CA 2E Modules: *ALL

Job: L,B Pgm: L,B

Parameters
The following are parameters for the YAPYTRNMDL command

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

39

YAPYTRNMDL (Apply Translation to Model) Command

MDLLIB
Name of library containing a design model to which the translations are applied. The value for this parameter is described in the following:
n

*CURLIBUse current library for invoking job.

LNG
National language used for translation. Values for this parameter are described in the following:

DANDanish DTCGerman ELLGreek ENGEnglish ESPSpanish FINFinnish FRNFrench HRZCroatian ITAItalian JPNJapanese NDLDutch NSKNorwegian PTGPortuguese SLOSlovenian SVKSwedish UCSEnglish Upper Case

Notes

You must have the appropriate national language product library installed on your machine in order for the command to function. You must have object existence rights to all the objects in the model library to be able to run this command. The current national language of the data model is shown on the system parameter display (YDSPMDLVAL). The release level of the data model and the national language product level must be compatible.

310

Command Reference Guide

YBLDJOBLST (Build Job List) Command

Example
To translate system data files in the model MYMDL into French:
YAPYTRNMDL MDLLIB(MYMDL) LNG(*FRN)

YBLDJOBLST (Build Job List) Command

Builds a job list of selected objects in a design model. You can use this list in the following commands:

YSBMMDLCRT submits the job list to be generated and/or compiled. YCHKJOBLE checks the existence of corresponding source members and i OS objects for each job list entry. YCVTJOBLST converts the job list to a CA 2E Toolkit object list.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

311

YBLDJOBLST (Build Job List) Command

Optional
*ALL YBLDJOBLST APPCDE application area *ALL MDLFILE generic* model file name model file name *ALL MDLACP *NONE generic* access path name model access path name *ALL MDLACPYTYP *LGL One of the following: *PHY *UPD *RTV *RSQ *SPN *QRY *ALL *ACP MDLFUN *LGL generic* function name model function name *GEN *GEN ACPACT *CRT *NO *MDLLIB/ *CURLIB/ JOBLST *MDLPRF/ library name
*REPLACE LSTOPT *ADD CA 2E Modules: *ALL CUROBJ *NO Job: L,B Pgm: L,B

MDLFUNSEL *FIL

FUNACT *CRT *MDLPRF *USER

*WRKSTN job list name

*YES

Parameters
The following are parameters for the YBLDJOBLST command.

312

Command Reference Guide

YBLDJOBLST (Build Job List) Command

APPCDE
Name of the application area from which the objects to be included in the job list are selected. The value for this parameter is as follows:

*ALL(default) Include functions and access paths from all application areas.

MDLFILE
Generic name of files whose dependent access paths and/or functions are included in the job list. Values for this parameter are described in the following:

*ALL(default) Include the objects dependent on all user-defined files in the model. *GENERICUse generic name.

MDLACP
Generic name of access paths that are included in the job list. Values for this parameter are described in the following:

*ALL(default) All access paths for the specified files are included. *NONENo access paths are included. *GENERICUse generic name.

MDLACPTYP
Specifies the type or types of access paths you want to include in the job list. Values for this parameter are described in the following:

*ALL(default) Include all access path types. *LGLInclude all types of access paths other than PHY. *PHYInclude only physical access paths. *UPDInclude only update access paths. *RTVInclude only retrieval access paths.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

313

YBLDJOBLST (Build Job List) Command

*RSQInclude only resequence access paths. *QRYInclude only query access paths. *SPNInclude only span access paths.

MDLFUN
Generic name of functions included in the job list. Values for this parameter are described in the following:

*ALL(default) Include all functions for the specified files or access paths. *NONEDo not include any functions. *GENERICUse generic name.

MDLFUNSEL
Specifies whether the functions you want to include in the job list are those based on the selected files or those based on the selected access paths. Values for this parameter are described in the following:

*ACP(default) Select functions based on the access paths specified by the MDLACP and MDLACPTYP parameters. *FILSelect functions based on the files specified by the MDLFIL parameter.

ACPACT
Activity to be requested for job list entries for access paths. Values for this parameter are described in the following:

*GEN(default) Generate and compile. *CRTCompile only. *NODo not add to job list, only use to select functions.

FUNACT
Activity to be requested for job list entries for functions. Values for this parameter are described in the following:

*GEN(default) Generate and compile. *CRTCompile only.

314

Command Reference Guide

YBLDJOBLST (Build Job List) Command

JOBLST
Qualified name of a job list where you place entries. Values for this parameter are described in the following:

*MDLPRF(default) The job list name is retrieved from the model profile details for the current user. *MDLLIB/*USERDefault the job list name to user profile name, and store list in model library. *WRKSTNDefault the job list name to job name of invoking job. *MDLPRF/The job list library is retrieved from the model profile details for the current user.

LSTOPT
List replacement option. Values for this parameter are described in the following:

*REPLACE(default) Create a new list, replacing any previous list's contents. *ADDAdd to any existing list's contents.

CUROBJ
Controls whether only current objects are included in the output list. Values for this parameter are described in the following:

*YES(default) Non-current objects are ignored in the build. *NOAll objects are included in the build.

Notes

If a value of *NONE is specified for the MDLACP parameter, then a value of *ACP is not allowed for the MDLFUNSEL parameter. If a value of *NONE is specified for the MDLACP parameter, then a value of *NONE is not allowed for the MDLFUN parameter. For each access path or function selected, the YBLDJOBLST command will add entries to the job list for the necessary implementation objects. For example, for an interactive function, both the program and the display file will be added to the job list. The library specified for the job list must be the same as the model library. A completion message is returned, giving a count of the number of access paths and functions added to the list.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

315

YBLDMDLLST (Build a Model Object List) Command

Only external functions based on a specified file/access path are selected. If an internal function is based on the specified file/access path, the external functions which use the internal function will not be selected (unless they also are based on the specified file/access path). File to file dependencies are not handled by this command. For example, if an order detail file is owned by an order file and the order file is changed, then the access paths/functions based on the order detail file will only be selected by YBLDJOBLST if the order detail file is specified in the MDLFILE parameter.

Example
To build a job list of all access paths and functions in a design model:
YBLDJOBLST

To build a job list of all functions in a design model over all files and access paths, but omitting the access paths from the job list:
YBLDJOBLST

To build a job list of all logical access paths and functions in a design model which are based on files whose names start with Order:
YBLDJOBLST MDLFILE(ORDER*) + MDLACPTYP(*LGL)

YBLDMDLLST (Build a Model Object List) Command

This command allows a user to build a model object list. The list may or may not exist. If it exists, it can be added to or replaced by taking the appropriate option on the LSTOPT parameter. Only certain model objects can be selected for inclusion in a list. See the command diagram for a list of valid object types. Once the list has been built, it can be used by the other model list processing commands. Normally a user will edit a list after creation using the Edit Model Object List command (YEDTMDLLST), or process entries in the list using one of the model list processing commands. See the command diagram of these commands for more details.

316

Command Reference Guide

YBLDMDLLST (Build a Model Object List) Command

*ALLOBJ *SELECT *ANY *NONE *ACP YBLDMDLLST OBJNAM *ARRAYS *MESSAGES *CND owner name *FLD *FIL *FUN *MSG max 5 *MDLPRF *MDLLIB/ MDLLST model library/ list name *REPLACE LSTOPT *ADD *SAME OUTFLAGVAL *NONE *SELECTED *SAME OUTCPYOBJ *NONE *SELECTED *NO INCSYSOBJ *YES
*YES CUROBJ *NO CA 2E Modules: *ALL FILTER *NO Job: L,B Pgm: L,B *YES

object name

*APP *ARR

*USER

Parameters
The following are parameters for the YBLDMDLLST command.

OBJNAM
The object name to be added. This parameter consists of three elements which together identify a model object. Values for this parameter are described in the following:

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

317

YBLDMDLLST (Build a Model Object List) Command

*ALLOBJ(default) Single value indicating that all model objects are included. *SELECTSingle value indicating that the object to be added is selected using an interactive display function. object owner nameGeneric name of the object that owns the object(s) to be added. Thus, for a function, the owning file would be entered. *ARRAYSSpecial value for the product internal file *ARRAYS. *MESSAGESSpecial value for the product internal file *MESSAGES. object nameGeneric name of the object(s) to be added. object typeThe object type of the object. *ALLAll object types are added. *ACPObject is of type access path. *APPObject is of type application area. *ARRObject is of type array. *CNDObject is of type condition. *FILObject is of type file. *FLDObject is of type field. *FUNObject is of type function. *MSGObject is of type message.

MDLLST
The qualified name of the model object list that is built. All output is directed to the list specified in this parameter. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. list nameThe name of the list to be built can be entered. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the target model for the list. library nameThe name of the model library to be the target of the command.

318

Command Reference Guide

YBLDMDLLST (Build a Model Object List) Command

LSTOPT
This parameter specifies the action taken if the list already exists in the model. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list is replaced with the output from this command. *ADDThe existing model object list is augmented with the output from this command.

OUTFLAGVAL
This parameter specifies the initial value to be placed in the object selected flag associated with each list entry. Values for this parameter are described in the following:

*SAME(default) No flag value is used. New entries are written with the flag indicating that the entry is not selected. There is no change to the selection status of existing entries. *NONENew and existing entries are flagged as not selected. *SELECTEDNew and existing list entries are flagged as selected. This flag may be used by other list commands when selecting list entries.

OUTCPYOBJ
This parameter specifies the initial value to be placed in the copy object flag associated with each list entry. This flag is used by the Copy Model Object command (YCPYMDLOBJ) when selecting objects to copy to a target model. Values for this parameter are described in the following:

*SAME(default) No flag value is used. New entries are written with the flag indicating that the entry is not selected. There is no change to the selection status of existing entries. *NONENew and existing entries are flagged as not selected. *SELECTEDNew and existing list entries are flagged as selected.

INCSYSOBJ
This parameter allows the user to control whether system objects are included in the output list. Values for this parameter are described in the following:

*NO(default) The system objects are not included. *YESSystem objects are included.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

319

YBLDMDLLST (Build a Model Object List) Command

CUROBJ
This parameter allows the user to control whether only current objects are included in the output list. Values for this parameter are described in the following:

*YES(default) Non-current objects are ignored in the build. *NOAll objects are included in the build.

FILTER
The initial output of the command can be filtered. If specified, this parameter invokes the Filter Model Object List command (YFLTMDLLST). Values for this parameter are described in the following:

*NO(default) The filter command is not invoked. *YESFiltering is required.

Notes

The target library for output must be a valid model library. Object lists are be created in file YMDLLSTRFP which resides in the model library. Each list is a separate member in that file. If a value other than *MDLLIB is used for the output list, the specified model library will also be used for object selection. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. *SELECT is invalid for OBJNAM if the job in which the command is running is of type batch. The LSTOPT parameter is ignored if the model object list does not already exist. The FILTER parameter is ignored if the job running the command is a batch job, since the method for defining the filter criteria is via the command prompter, requiring an interactive display.

Example
To build model object list MYLIST from all access paths and functions in the model contained in the current library list:
YBLDMDLLST OBJNAM( (*ANY *ALL *ACP) + (*ANY *ALL *FUN) )

320

Command Reference Guide

YCHGMDLLE (Change a Model Object List Entry) Command

YCHGMDLLE (Change a Model Object List Entry) Command

This command allows a user to change the selection flags of a model object list entry.

Required
YCHGMDLLE OBJSGT object surrogate

Optional
*MDLPRF *MDLLIB/ MDLLST model library *SELECT list name *USER

*SAME *NONE OBJSEL *SELECTED *ERROR

*SAME CPYOBJ *NONE *SELECTED CA 2E Modules: *ALL Job: L,B Pgm: L,B

Parameters
The following are parameters for the YCHGMDLLE command.

OBJSGT
Unique number identifier of the model object that is changed. The value for this parameter is as follows:

object surrogateThe surrogate number of the model object is required.

MDLLST
The qualified name of the model object list in which the entry to be changed exists. Values for this parameter are described in the following:

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

321

YCHGMDLLE (Change a Model Object List Entry) Command

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is to be used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe name of the list. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used. library nameThe name of the model library.

OBJSEL
This parameter specifies the value to be placed in the object selected field of the list entry. Values for this parameter are described in the following:

*SAME(default) The value currently in this field is not changed. *NONEThe entry is flagged as not selected. *SELECTEDThe entry is flagged as selected. *ERRORThe entry is flagged in error.

CPYOBJ
This parameter specifies the value placed in the copy object field of the list entry. Values for this parameter are described in the following:

*SAME(default) The value currently in this field is not changed. *NONEThe entry is flagged as not selected. *SELECTEDThe entry is flagged as selected.

Notes

The flagging of list entries is intended to allow users to perform operation on subsets of model objects contained in model object lists. Note that the object selected field (OBJSEL) is recognized by many of the list commands. However, the copy object field (CPYOBJ) is recognized only by the Edit Copy List command (YEDTCPYLST) and the Copy Model Objects command (YCPYMDLOBJ). A value of *SELECTED in the copy object field effectively means explicitly selected or selected for copying for the purposes of the Copy Model Objects command (YCPYMDLOBJ).

322

Command Reference Guide

YCHGMDLOBJ (Change Model Object) Command

Both the model object list and the list entry must exist prior to running this command.

Example
To change the model object list entry for the object identified by surrogate number 1100911, in model object list DEVLST in the first model library to be found in the current library list, and to flag the entry as *SELECTED for use in another list command:
YCHGMDLLE OBJSGT( 1100911 ) MDLLST + (*MDLLIB/DEVLST ) OBJSEL( *SELECTED )

YCHGMDLOBJ (Change Model Object) Command

This command provides access to certain user-definable data that is stored for each model object. The command diagram described below shows which data are available to be updated. We recommend that you use this information to support a user-defined change control facility operating on a model.

Required
*OBJSGT *SELECT

*NONE YCHGMDLOBJ OBJNAM *ARRAYS *MESSAGE S owner name object name

*ACP *APP *ARR *CND *FIL *FLD *FUN *MSG

OBJNAM OBJSGT object surrogate

*MDLLIB MDLLIB model library name

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

323

YCHGMDLOBJ (Change Model Object) Command

Optional
*SAME *PUBLIC *PRIVATE CHGTYP *GEN *OBJONLY *NONE

*SAME *SAME IPCPRC *YES *NO PRMTYP *ADD *CHG *GEN *NONE
*SAME *SAME *DEV VSNTYP *PRD *ARC (1) VSNSNC *YES *NO

*SAME (1) CHKDTE *NONE *DATE date *SAME (1) CHKUSR *NONE *USER user name
*SAME (1) CHKLST *NONE *USER model object list
*SAME (1) CHKSTS *NONE *USER character value (1) This field is intended for use by a change management system, .

*SAME (1) CHKTME *NONE *TIME time

CA 2E Modules: *ALL

Job: L,B Pgm: L,B

Parameters
The following are parameters for the YCHGMDLOBJ command

324

Command Reference Guide

YCHGMDLOBJ (Change Model Object) Command

OBJNAM
The object name to be changed. This parameter consists of three elements that together identify a model object. Values for this parameter are described in the following:

*OBJSGT(default) Single value indicating that the object surrogate is to be used to identify the model object that is to be changed. *SELECTSingle value indicating that the object to be changed is selected using an interactive display function. object owner nameThe character name of the object that owns the object to be changed. Thus, for a function, the owning file would be entered. *NONESpecial value indicating that the object concerned does not have an owner; for example, objects of type *FIL. *ARRAYSSpecial value for the product internal file *ARRAYS. *MESSAGESSpecial value for the product internal file *MESSAGES. object nameThe character name of the object to be changed. object typeThe object type of the object. *ACPObject is of type access path. *APPObject is of type application area. *ARRObject is of type array. *CNDObject is of type condition. *FILObject is of type file. *FLDObject is of type field. *FUNObject is of type function. *MSGObject is of type message.

OBJSGT
Unique number identifier of the model object whose details are to be changed. Values for this parameter are described in the following:

*OBJNAM(default) Use object name to identify the model object to be changed. object surrogateThe surrogate number of the model object.

MDLLIB
The data model that is to be edited. Values for this parameter are described in the following:

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

325

YCHGMDLOBJ (Change Model Object) Command

*MDLLIB(default) The model to be edited is the first one found in the current job's library list. model nameThe name of a specific data model.

CHGTYP
Reflects the type of change that has been made to the object. Note that changing this field may also cause the Action required flag (ACTRQD) for objects that use this object to be updated. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *PUBLICThe object has been publicly changed. Appropriate component change processing will be performed. *PRIVATEThe object has been privately changed. Appropriate component change processing will be performed. *GENThe object has been changed requiring generation of the implementation object only. This is only valid for generatable objects. No component change processing will be performed. *OBJONLYThe object has been changed. However, the change does not affect using objects and no source generation is required. *NONEThe object has been changed but requires no further action. No component change processing will be performed.

IPCPRC
Indicates whether users of the object have been processed to reflect the effect on them resulting from the change made to the object. A Change type (CHGTYP) of *PRIVATE or *PUBLIC recorded for the object will have an effect on its users. When the effect is established during component change processing, the impact processed flag is set to *YES. As a result, changing this flag will either cause component change processing to be performed or avoided, depending on the value to which it is set. Values for this parameter are described in the following:

*SAME(default) The current value is not to be changed. *YESThe object is to be treated as if component change processing had been performed. *NOThe object is to be treated as if component change processing had not been performed. As a result, if the Change type (CHGTYP) value is *PRIVATE or *PUBLIC, component change processing will be invoked either the next time the object is changed if component change processing is set to occur interactively when the Apply Component Changes (YAPYCMPCHG) command is run.

326

Command Reference Guide

YCHGMDLOBJ (Change Model Object) Command

PRMTYP
Promotion type to be performed on this object, as part of a change control system. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *ADDThe object is to be added to the target environment. *CHGThe object is to replace the same object in the target environment. *GENThe object is to be regenerated only in the target environment; the design object is not to be promoted. *NONENo promotion type is to be associated with the object.

VSNTYP
This field identifies the status of an object with respect to other members of a group of objects. A group is defined by those objects that originated (were copied) from the same object or another member of the group. This field is intended for use with a promotion procedure and identifies which version of a group is the development version, the production version, and the archive version. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *DEVChange the model object value to indicate that it is the development version. *PRDChange the model object value to indicate that it is the production version. *ARCChange the model object value to indicate that it is the archive version.

VSNSNC
This user-defined field is intended for use by a change management system. You could set it in a checkout procedure to indicate that a version of an object is in conflict with another version; for example, when an object is checked out by two users. The conflict could then be detected when you attempt to promote one of the versions. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *YESChange the model object value to indicate that the condition represented by yes is true; for example, *YES could indicate that a conflict exists. *NOChange the model object value to indicate that the condition represented by no is true; for example, *NO could indicate that no conflict exists.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

327

YCHGMDLOBJ (Change Model Object) Command

CHKDTE
This user-defined field is intended for use by a change management system, to contain the date a checkout procedure was run to check out the model object. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *NONEA special value meaning that any value in this field is to be replaced with zero. *DATEA special value meaning that the current system date is to be used. dateA date value may be entered.

CHKTME
This user-defined field is intended for use by a change management system, to contain the time a checkout procedure was run to check out the model object. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *NONEA special value meaning that any value in this field is to be replaced with zero. *TIMEA special value meaning that the current system time is to be used. timeA time value may be entered.

CHKUSR
This user-defined field is intended for use by a change management system, to contain the user profile of the user who ran a checkout procedure to check out the model object. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *NONEA special value meaning that any value in this field is to be replaced with blanks. *USERThe name of the current user profile is used to update the model object value. user nameA user profile name can be entered.

328

Command Reference Guide

YCHGMDLOD (Change Model Object Description) Command

CHKLST
This user-defined field is intended for use by a change management system, to contain the name of the model object list from which the model object was checked out as part of a checkout procedure. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *NONEA special value meaning that any value in this field is to be replaced with blanks. *USERThe name of the current user profile is used to update the model object value. list nameA model object list name can be entered.

CHKSTS
This user-defined field is intended for use by a change management system, to contain the checkout status of the model object when used as part of a checkout procedure. Values for this parameter are described in the following:

*SAME(default) The current model object value is not to be changed. *NONEA special value meaning that any value in this field is to be replaced with blanks. character valueA user-defined value can be entered.

Example
To change the Order Details file, enter the following:
YCHGMDLOBJ OBJNAM( *NONE 'Order Details' + *FIL)

YCHGMDLOD (Change Model Object Description) Command

This command accesses an interactive panel that displays the details for a given model object. All details are display only. For more information on using the interactive panel, see online Help for the specific panel.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

329

YCHGMDLOD (Change Model Object Description) Command

Required
*OBJSGT *SELECT

*NONE YCHGMDLOD OBJNAM *ARRAYS *MESSAGE S owner name object name

*ACP *APP *ARR *CND *FIL *FLD *FUN *MSG

OBJNAM OBJSGT object surrogate CA 2E Modules: *ALL MDLLIB

*MDLLIB

model name Job: L Pgm: L

Parameters
The following are parameters for the YCHGMDLOD command.

OBJNAM
The name of the model object to be changed. This parameter consists of three elements that together identify a model object. Values for this parameter are described in the following:

*OBJSGT(default) Single value indicating that the object surrogate is to be used to identify the model object that is to be changed. *SELECTSingle value indicating that the object to be changed is selected using an interactive display function. object owner nameThe character name of the object that owns the object to be changed. Thus, for a function, the owning file would be entered. *NONESpecial value indicating that the object concerned does not have an owner; for example, objects of type *FIL. *ARRAYSSpecial value for the product internal file *ARRAYS. *MESSAGESSpecial value for the product internal file *MESSAGES. object nameThe character name of the object to be changed.

330

Command Reference Guide

YCHGMDLOD (Change Model Object Description) Command

object typeThe object type of the object. *ACPObject is of type access path. *APPObject is of type application area. *ARRObject is of type array. *CNDObject is of type condition. *FILObject is of type file. *FLDObject is of type field. *FUNObject is of type function. *MSGObject is of type message.

OBJSGT
Unique number identifier of the model object that is to be changed. Values for this parameter are described in the following:

*OBJNAM(default) Use object name to identify the model object to be changed. object surrogateThe surrogate number of the model object.

MDLLIB
The data model in which the object whose description is to be changed resides. Values for this parameter are described in the following:

*MDLLIB(default) The model is the first one to be found in the current library list. model nameThe name of a specific data model.

Notes

A value other than *MDLLIB for MDLLIB may result in the library list being changed. If you are currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. Model objects can either be identified by object name (OBJNAM) or by object surrogate key number (OBJSGT). If the OBJNAM parameter is used, the processing program must convert to surrogate key number internally. Thus, it will normally be more efficient to use the surrogate number if this value is available. The surrogate number for an object can be obtained using the Retrieve Model Object command (YRTVMDLOBJ). Model object names are structured as follows:

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

331

YCHGMDLPRF (Change Model Profile) Command

Type ACP APP ARR CND FIL FLD FUN MSG

Name File name/Access path name/'ACP' ---/Application area code/'APP' *Arrays/Array name/'ARR' Field name/Condition name/'CND' ---/File name/'FIL' ---/Field name/'FLD' File name/Function name/'FUN' *Messages/Message name/'MSG'

Example
To change the Edit Order Details function, which is owned by the Order Details file, enter the following:
YCHGMDLOD OBJNAM('Order Details' 'Edit Order + Details' *FUN)

YCHGMDLPRF (Change Model Profile) Command

Certain data is stored in each data model associated with user profiles of developers. This command allows these values to be adjusted.

Required
YCHGMDLPRF MDLPRF model user profile name

332

Command Reference Guide

YCHGMDLPRF (Change Model Profile) Command

Optional

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

333

YCHGMDLPRF (Change Model Profile) Command

*SAME SSNLST *MDLPRF list name *SAME COMPCHG *YES *NO VIEWONLY LOGCHG

*SAME *YES *NO *SAME *YES *NO

*SAME USROPT *LIBL QAUOOPT

library name/

file name

*SAME *FILE USROPTMBR *FIRST *MDLPRF member name *SAME

MDLLST

*MDLPRF

list name
*SAME *SAME

NPDFUN

*NONE

ADESRNMODE

*YES

notepad function
*SAME JOBLST *MDLLIB *CURLIB library name/ job list name *MDLPRF

*NO

*SAME *SAME *GENLIB *GENLIB GENLIB *CURLIB *OBJLIB library name library name *SAME *MDLLIB JOBD *CURLIB *LIBL jobd name library name/ *MDLVAL SRCLIB *CURLIB

334

Command Reference Guide

YCHGMDLPRF (Change Model Profile) Command

*SAME *NONE CRTJOBD *JOBD *MDLLIB *LIBL library name

*SAME SBMGENOPT *RLS *HLD
*SAME *MDLVAL SRNMODE *YES *NO folder name CA 2E Modules: *ALL Job: B, I Pgm: B, I GUIFLR *NONE

jobd name

*SAME SBMCRTOPT *GENOK *IMMED

*SAME

Parameters
The following are parameters for the YCHGMDLPRF command.

MDLPRF
The model user profile name that is changed. The value for this parameter is as follows:

user profile nameThe name of the user profile must be entered.

SSNLST
The name of the session list used when editing a model. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *MDLPRFThis special value indicates that the name of the current user profile is loaded to the session list field. list nameThe name of the list can be entered.

LOGCHG
This parameter indicates whether changed objects are logged to the specified session list while editing the model. Values for this parameter are described in the following:

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

335

YCHGMDLPRF (Change Model Profile) Command

*SAME(default) The current value is not changed. *YESChanged objects are logged to the session list. *NOChanged objects are not logged.

COMPCHG
This parameter indicates whether objects that use a changed object are to be flagged as having had a component changed. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *YESObjects which use a changed object are flagged when the object is changed. *NOComponent change processing is not performed when the object is changed. It may be performed later using the Apply Component Change command (YAPYCMPCHG).

VIEWONLY
This parameter indicates whether the current user is navigating the model in *VIEW mode or *EDIT mode. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *YESNavigation is in *VIEW mode. *NONavigation is as normal (*EDIT mode).

USROPT
The Edit Model List panel supports the use of user options to be applied to subfile records. This field stores the user option file name to use. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. QAUOOPTThe system-supplied user option file name. list nameUser-defined file name. *LIBLThis special value is used as the library name. library nameA library name can be entered.

336

Command Reference Guide

YCHGMDLPRF (Change Model Profile) Command

USROPTMBR
The member in the user options file that is used. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *FILEThe member name is the same as the user options file name. *FIRSTThe first member in the file is to be used. *MDLPRFThe member name is the same as the current user profile name. member nameThe user options member name.

MDLLST
The list used if *MDLPRF is specified on a model object list command. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *MDLPRFA list with the same name as the user profile is used.

NPDFUN
The user-defined notepad function to use when using the action diagram editor. The function specified must either be an Execute External Function (EXCEXTFUN) or an Execute Internal Function (EXINTFUN). Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *NONENo particular notepad function is specified, the action diagram editor will provide an empty notepad for use during editing sessions. notepad functionThe function name must be specified.

ADESRNMODE
This parameter provides the default for full screen mode when using the action diagram editor. Values for this parameter are described in the following:

*SAMEThe current value is not changed. *YESThe default for the action diagram editor full screen mode is yes. *NOThe default for full screen mode is no.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

337

YCHGMDLPRF (Change Model Profile) Command

JOBLST
When a user invokes the Submit Model Create command (YSBMMDLCRT), this qualified value can be used to determine the job list that is defaulted. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *MDLPRFA job list with the same name as the user profile is the default. list nameJob list name. *MDLLIBThis special value is used as the default library name. *CURLIBThis special value is used as the default library name. library nameDefault library name.

GENLIB
The default generation library name may be specified. When a user invokes the Submit Model Create command (YSBMMDLCRT), this value will be used by default. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *GENLIBThis special value is the default. *CURLIBThis special value is the default. library nameDefault library name.

SRCLIB
The default source library name may be specified. When a user invokes the Submit Model Create command (YSBMMDLCRT), this value will be used by default. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *GENLIBThis special value is the default. *CURLIBThis special value is the default. *OBJLIBSpecial value meaning that the source library name is the same as for the GENLIB parameter. library nameDefault library name.

338

Command Reference Guide

YCHGMDLPRF (Change Model Profile) Command

JOBD
The default job description name to use when a user invokes the Submit Model Create command (YSBMMDLCRT). This qualified value will be used as the default. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *MDLVALThis special value is the default. job description nameThe job description name. *MDLLIBThis special value is the default library in which to find the job description. *CURLIBThis special value is the default library in which to find the job description. *LIBLThis special value is the default library in which to find the job description.

CRTJOBD
The default create job description name to use when a user invokes the Submit Model Create command (YSBMMDLCRT). This qualified value will be used as the default. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *JOBDThis special value is the default. *NONEThis special value is the default. job description nameThe create job description name. *MDLLIBThis special value is the default library in which to find the job description. *LIBLThis special value is the default library in which to find the job description.

SBMGENOPT
The default generation option value to use when a user invokes the Submit Model Create command (YSBMMDLCRT). Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *RLSThis special value is the default. *HLDThis special value is the default.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

339

YCHGMDLPRF (Change Model Profile) Command

SBMCRTOPT
The default compilation option value to use when a user invokes the Submit Model Create command (YSBMMDLCRT). Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *GENOKThis special value is the default. *IMMEDThis special value is the default.

SRNMODE
This parameter determines whether or not the default panel on the Edit Model List command (YEDTMDLLST) is displayed in full screen mode. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *YESThe default for full screen mode is yes. *NOThe default for full screen mode is no.

GUIFLR
This parameter records the default value for the GUI folder value used when prompting the Submit Model Create (YSBMMDLCRT) command for the specified user. Values for this parameter are described in the following:

*SAME(default) The current value is not changed. *MDLVALThe value to be prompted is derived from the model value. *NONEThe default value is *NONE. folder nameEnter the name of a folder.

Notes

User profile values for a particular developer are updated while using the Edit Model Object List command (YEDTMDLLST). The YCHGMDLPRF command may be used to adjust values outside the YEDTMDLLST command. The processing of the VIEWONLY parameter occurs in the user access exit program (YUSROBJR1C). The shipped default processing switches from *EDIT to *VIEW mode if the VIEWONLY parameter is set. Users should be careful, therefore, when changing the processing of this exit program, to take account of such processing.

340

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Example
To log changed objects to model list CHGOBJ and to perform component change processing the next time user KATHY edits the model:
YCHGMDLPRF MDLPRF( KATHY ) CHGLST + (CHGOBJ ) LOGCHG( *YES ) COMPCHG( *YES )

YCHGMDLVAL (Change Model Value) Command

Changes a model value.

Required
YCHGMDLVAL (1) MDLVAL model value name (1) Value model value

CA 2E Modules: *ALL

(1) One of the allowed values; see tables which follow.

Job: I,B Pgm: I,B

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

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

341

YCHGMDLVAL (Change Model Value) Command

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 YABRNPT YACTCND YACTFUN YACTSYM YACTUPD YALCVNM YBNDDIR YCHGCTL YCMPCHG YCMPTXT YCMTCDE YCNFVAL YCPYLIB YCPYMSG YCRTENV YCRTJBD YCUAEXT YCUAPMT YCUTOFF YDATFMT Description Action/DDS Menu Bars Action diagram compound symbols Action diagram compute symbols Action diagram structure symbols Default update flag value on action diagram exit Automatic name allocation ILE Binding directory Change control library Component change processing control Company text Include Inactive Code Confirm value Copy library Copy back messages Creation environment Job description CUA device extension CUA prompt Date range for 2-digit year input dates Date format Grouping Design Option Design Option Design Option Design Option Environment Name Allocation Environnent Environment Environment Environment Environment Function Generation Environment Function Generation Environment Environment Design Option Design Option Function Generation Function Generation

342

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Model Value YDATGEN YDBFACC YDBFGEN YDFTCTX YDSTFIO YERRRTN YEXCENV YFILPFX YFRFPFX YFRFTXT YFRFVNM YGENCMT YGENGUI YGENHLP YGENLIB YGENLMT YGENRDB YGUIAKY YGUICMD YGUIFLR YGUIHLP YGUILIB YGUILSO YGUIOPR YGUISEL YGUITKY YHLLCBL YHLLGEN YHLLVNM

Description Date generation Database access method Database implementation Parameter default context Distributed file I/O control Error routine Execution environment File name prefix Field reference prefix Field reference file text Field reference file name Generate comments in source Generate GUI by default (Synon/TC) Generate help text Generation library Maximum job list entries for single YGENSRC job Generation RDB name Suppress aid keys (Synon/TC) Command key descriptor text (Synon/TC) Folder for GUI objects (Synon/TC) Default GUI help language (Synon/TC) Library partitioning for GUI (Synon/TC) Suppress list options (Synon/TC) Operator between prefix & text (Synon/TC) Subfile select descriptor text (Synon/TC) Display command keys per tab (Synon/TC) HLL Cobol HLL to generate HLL naming convention

Grouping Function Generation Access Path Generation Access Path Generation Function Generation Environment Function Generation Environment Name Allocation Access Path Generation Access Path Generation Access Path Generation Function Generation Function Generation Function Generation/ Help Generation Environment Function Generation Environment PWS Environment PWS Environment PWS Environment Help Generation PWS Environment PWS Environment PWS Environment PWS Environment PWS Environment Function Generation Function Generation Name Allocation

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

343

YCHGMDLVAL (Change Model Value) Command

Model Value YHLPCSR YIGCCNV YLHSFLL YLIBLST YMDLLIB YMDLLNG YMDLTXT YMSGNBR YMSGPFX YMSGVNM YNLLMDL YNLLUPD YNPTHLP YOBJPFX YOLDDBF YOLDLIB YOPNACC YPKYLIB YPKYVNM YPMTGEN YPMTMSF YPMTNBR YPUTOVR YRPGHDR YRPGHSP YRP4HSP YRP4HS2 YRP4SGN YSAAFMT YSCNLMT

Description Generate cursor sensitive text IGC support Leaders for device design Model library list name Model library Model language Model text Message number Message id prefix Message file name Null model Null update suppression NPT help default generation type Member name prefix Old DBF names Old library Open access to the model Print key file library Print key file Prompt implementation Prompt message file Prompt number DDS put with override RPG header specification RPG Control (H) Specification RPGIV Control (H) Specification (*PGM) RPGIV Control (H) Specification (*MODULE) RPGIV Generation Options SAA format Scan Limit

Grouping Help Generation Environment Design Option Environment Environment Environment Environment Name Allocation Name Allocation Name Allocation Unchangeable System Model Value Function Generation Help Generation Name Allocation Access Path Generation Environment Environment Function Generation Function Generation Function Generation Name Allocation Name Allocation Function Generation Function Generation Function Generation Function Generation Function Generation Function Generation Design Option Function Generation

344

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Model Value YSFLEND YSHRDFT YSHRSBR YSNDMSG YSQLLCK YSQLLEN YSQLLIB YSQLVNM YSQLWHR YSYSCHG YSYSDBF YSYSHLL YSYSLNG YSYSNPT YSYSPMT YSYSSAA YTRGLIB YTRNAPI YUIMBID YUIMFMT YUIMIDX YVLSPFX YWBDATR YWBDCHR YWBDCLR YWSNGEN YW2ELIB

Description Subfile end Sharing default Share function subroutines Send error message SQL locking SQL naming length SQL collection library SQL naming SQL Where clause Change control library System database access Default HLL System language System default NPT help generation type System prompt Default SAA formatting option Trigger Runtime library Convert Case API Bi-directional UIM help text Default UIM format UIM search index Value list prefix Window border attribute Window border characters Window border background color Workstation environment Web Option Product Library

Grouping Design Option Design Option Function Generation Function Generation Function Generation Access Path Generation Environment Access Path Generation Function Generation System Defaults System Defaults System Defaults Unchangeable System Model Value System Defaults System Defaults System Defaults Environment Function Generation Help Generation Help Generation Help Generation Name Allocation Design Option Design Option Design Option Function Generation Function Generation

Model Values Grouped By Role

Following are the model values grouped according to their role.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

345

YCHGMDLVAL (Change Model Value) Command

Design Option Values

Model Value YABRNPT Description Allows you to choose between creation of CA 2E Action Bars or DDS Menu Bars for a given function. Symbols used in editing a compound condition. Allowed Values *DDSMNU *ACTBAR 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. 8 sets of up to 3 characters each separated by blanks used to represent the arithmetic operations, parenthesis and functions.

YACTCND

YACTFUN

Symbols used in editing a compute expression.

YACTSYM

Symbols used to indicate the action diagram *SAADefault to symbols, :, |, , or symbols :, |, . Used in action diagram editor you can pick three symbols of your own choice. and YDOCMDLFUN. 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.

*C89EXTThis value will provide right-hand side text and extra spacing in line with the 1989 CUA extensions. *DEFAULTThis value will not provide right-hand side text and extra spacing. *MDLWill pick it up from YSAAFMT. If YSAAFMT = CUATEXT, F4 will be enabled within the generated application. *YESF4 will be enabled within the generated application. *NOF4 will not be enabled. *CALCSee the notes that follow.

YCUAPMT

Enables the CUA prompt. The default is F4.

YLHSFLL

Symbols to be used as leaders between screen text and screen fields.

*SAAWill 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.

346

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Model Value YSAAFMT

Description Screen device convention to be defaulted for use in the device design editor. (System/38, CUA Entry, or CUA Text)

Allowed Values *CUAENTRYDefaults to a header/footer without windows or action bars. *CUATEXTDefaults 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. *S38Defaults to System/38 style header/footer.

YSFLEND

Controls whether + or More. . . is displayed if *PLUSDisplay the + sign to indicate that the subfile contains more records. additional subfile records are available for display. *TEXTDisplay More. . . to indicate that the subfile contains more records. Display Bottom to indicate that the last subfile record is displayed. 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. *ALLAll keys that match existing fields, other than the last key of the relation, are automatically shared. *NONENo keys are automatically shared. This is a recommended default when using Gateway/SR.

YSHRDFT

YWBDATR

Window border attribute that is to be the default for device designs.

*CUAShadowed window. *SHADOWShadowed window. *NOSHADOWStraight lined window.

YWBDCHR

Window border characters. The field length is 8, with each number referencing a border section: 1 2 3 4 5 6 7 8 Top left corner character Horizontal top line Top right corner character Vertical left line character Vertical right line character Bottom left corner character Horizontal bottom line Bottom right corner character

*CUADots 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.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

347

YCHGMDLVAL (Change Model Value) Command

Model Value YWBDCLR

Description Window border background color.

Allowed Values *CUADefault 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

<<< <<< <<< <<< <<< <<< <<< <<<

348

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

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 PMTRCD DSPFIL SELRCD DSPRCD,2,3 EDTRCD, 2,3 EDTFIL DSPTRN EDTTRN

Function Field Initialization No No No 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.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

349

YCHGMDLVAL (Change Model Value) Command

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 5 1 6 3 4 7 2 8

Position Top left corner Top horizontal Top right corner Left vertical Right vertical Bottom left corner Bottom horizontal Bottom right corner

Value . . . : : : . :

350

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Name Allocation Values

Model Value YALCVNM Description Specifies whether field and object names are to be allocated automatically by CA 2E. Allowed Values

*YES *NO *MNCWill 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. Specifies HLL or HLLs with which new names will comply.

Two-character prefix.

YHLLVNM

*RPG *CBL *RPGCBLAllocate both RPG and Cobol. *VNMSame language as YHLLGEN option is allocated.

YMSGNBR YMSGPFX

The last assigned message number in the message file named by YMSGVNM. Message prefix to be given to message identifiers issued automatically by CA 2E. Name of default message file in GENLIB to place message descriptions in.

AAAA to 9999 Message prefix or *NO VNM(3)

YMSGVNM

*NONE *MSGPFX VNM(10)

YOBJPFX

Prefix to use when generating system object names. Device prompt message file.

Two-character prefix that will be attached to your generated objects.

YPMTMSF

Valid System NameSpecify your own. *NONE *PMTMSFDefault name provided.

YPMTNBR

The last assigned prompt message number in the message file named by YPMTMSF.

0001 to 9999

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

351

YCHGMDLVAL (Change Model Value) Command

Model Value YVLSPFX

Description Prefix to be given to value list profile and the program that calls it. See YCVTCNDVAL.

Allowed Values 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 YDBFACC Description Specifies whether data is accessed using the SQL table directly or an SQL view. Allowed Values

*DBFGENAccess data using a view. *TABLEAccess data directly from the SQL table. *DDS *SQL

YDBFGEN

Defines the method for database definition, either DDS or SQL. The default is the value defined by the YSYSDBF model value. Prefix for fields in field reference file. Text for field reference file. Name of field reference file. Controls display of the old DBF name field on the Edit Field Details display. Controls the length of the extended SQL name.

YFRFPFX YFRFTXT YFRFVNM YOLDDBS

Valid System NameSpecify your own. Character string Valid System Name or *NONE

*YESDisplay YES. *NODisplay NO.

YSQLLEN

A numeric value up to 25. This model value is used only when YSQLVNM is *SQL.

YSQLVNM

Specifies whether to assign DDS names or model object names to SQL tables and columns.

*DDSUse DDS names. *SQLUse the names of the CA 2E model objects; in other words, use extended SQL naming.

352

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Function Generation Values

Model Value YCNFVAL Description Specifies initial value for confirm prompt. Allowed Values

*YES *NO *YES *NO 1940 19YYwhere YY is a numeric value between 00 and 99; in other words, a 4-digit year between 1900 and 1999

YCPYMSG

Specifies whether outstanding messages are to be copied back to the calling program. 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. 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. Date validation generation option: MDY, YMD, DMY, VRY - if VRY see YDATFMT value

YCUTOFF

YDATFMT

*DMYDate, Month, Year *YMDYear, Month, Date *MDYMonth, Date, Year *DMY *YMD *MDY *VRY *WRKUse WRK context for parameter defaulting. *LCLUse LCL context for parameter defaulting.

YDATGEN

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.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

353

YCHGMDLVAL (Change Model Value) Command

Model Value YERRRTN

Description Specifies whether an error handling routine is to be generated.

Allowed Values

*YESGenerate error handling routine. *NODo not generate error handling routine. *ALLAll comments are generated into the source for a function. *HDROnly header comments are generated. *NONo comments are generated. *STDCurrently the same as *ALL. To be used in a future release. *YESGenerate a GUI interface for functions that use a screen device design. *NODo not generate a GUI interface. *ONLYGenerate 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. *YESGenerate help text (UIM or TM) with all other HLLs. *NODo not generate help text. *ONLYGenerate help text only (without other HLLs).

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.

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.

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.

354

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Model Value YGENLMT

Description

Allowed Values

Specifies the maximum number of job list entries 1-99999 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. Specifies Cobol version.

YHLLCBL

*CBL85 *CBL74 *RPG *CBL *NOCHGOBJ functions always update the database whether the record changed or not. *AFTREADCHGOBJ checks whether to suppress database update after the After Data Read user point. *YESCHGOBJ checks whether to suppress database update both after the After Data Read and after the Data Update user points. Valid System Name Specify your own. *LIBLWill pick up name from your library list. *NONE Valid System Name *NONE

YHLLGEN

Default HLL type to be given to new functions.

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.

YPKYLIB

Print file library name.

YPKYVNM

Print file name for use on DSPF DDS PRINT keyword: specifies name of spool file for PRINT key output.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

355

YCHGMDLVAL (Change Model Value) Command

Model Value YPMTGEN

Description 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.

Allowed Values

*OFFThis model is incapable of generating message IDs for screen text literals. (default *MSGIDThis model will default to generated external message IDs for every screen text constant. *LITERALThis model is capable of generating external message IDs but will not default to do so. You can override at the function level. *YESGenerate PUTOVR in the DDS. *NODo not generate PUTOVR in the DDS.

YPUTOVR

Specifies whether code is to be generated using PUTOVR option in DDS.

YRPGHSP YRP4HSP YRP4HS2 YRP4SGN

Specifies H specification line to be used for RPG programs. Specifies H Specification line to be used for RPGIV Programs (*PGM) Specifies H Specification line to be used for RPGIV Modules (*MOD) The options which are used to generate RPGIV (RPGLE) source in the model. See help text for more information 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. Indicates whether generated source code for subroutines is to be shared and whether the subroutines interface is internal or external.

H specification (80) H Specification VNM(80) H Specification VNM(80) 1st character U,M,L 2nd character G,W,R,B,P

YSCNLMT

1- 999999999

YSHRSBR

*NOGenerate source code each time the subroutine is called. The subroutines interface is internal. *YESShare the first instance of generated source for all subsequent calls to the subroutine. The subroutines interface is external.

356

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Model Value YSNDMSG

Description Specifies whether all messages are to be sent, or only the first one detected. Specifies whether a row to be updated will be locked at the time it is read or at the time it is updated.

Allowed Values

*YES *NO *UPDLock row at time of update. *FETIf a SELECT is done, lock row at time of read; else lock row at time of update. *IMGLock row at time of read for CHGOBJ's embedded in the DBF record user point of standard Edit functions. *ORUse OR logic when generating SQL WHERE clauses. *NOTUse NOT logic when generating SQL WHERE clauses. *NPTWill generate for non-programmable terminals. *GUIGenerates for non-programmable terminals together with a Windows executable. *JVAGenerates for non-programmable terminals together with a Windows executable and a Java executable. *VBGenerates for non-programmable terminals together with a Visual Basic executable.

YSQLLCK

YSQLWHR

Specifies whether to use OR or NOT logic when generating SQL WHERE clauses.

YWSNGEN

Defines whether interactive CA 2E 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.

YW2ELIB

The name of the Web Option product library that is associated with this model if HTML templates are being generated YRP4SGN

VNM (10) - Valid library name.

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:

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

357

YCHGMDLVAL (Change Model Value) Command

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 will be 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

358

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Model Value YACTUPD

Description Defines the default value for the change/create function option on the exit function definition panel.

Allowed Values

*YESOption will always default to Y. *NOOption will always default to N. *CALCOption is set to Y only when a change to the functions action diagram or panel design has been detected. *NONERestricted exit programs will not be called. Change control additional features are effectively off. Valid library name.

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).

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

359

YCHGMDLVAL (Change Model Value) Command

Model Value YCMPCHG

Description Determines whether component change processing happens interactively and the access which developers have to the component change processing flag on their model.

Allowed Values

*NONENo interactive component change processing occurs while editing model objects unless running the YAPYCMPCHG command. *LIMITEDComponent change processing will occur if developer's model profile is set to Y. Only *DSNR authorized developers can change the model profile value. *UNLIMITEDComponent change processing will occur if developer's model profile is set to Y. Developers may change the model profile value as they wish. *GENThe 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 TEXT (30) banner of generated code. It is displayed on the right-hand side and header/footer. Determines whether commented-out (Inactive) code in the Action Diagram will be included when determining Object Usages and References

YCMTCDE

*YES Inactive code is included. *NO Inactive code is not included *IGN - there is no differentiation between active code and inactive code. Valid System Name *NONE

YCPYLIB

Name of library from which old physical file data is to be copied.

360

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Model Value YCRTENV

Description Object creation environment: IBM i or System/38

Allowed Values

QCLCreate environment for S/38. QCMDCreate environment for IBM i. VNM (10)Valid job description name. *SYNONSynon provides for control rolling between databases. *USERUser provides for control rolling between databases. *NONENo distributed functionality is generated. QCLPrepare execution for S/38. QCMDPrepare execution for IBM i.

YCRTJBD YDSTFIO

Name of job description to use when submitting compilations. Default to QBATCH. For SQL DRDA support, the distributed file I/O control option.

YEXCENV

Runtime environment: Specifies default initial value for execution environment for EXCMSG functions.

YGENLIB YGENRDB

Name of the generation library. 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. Generate IGC (Kanji ideographic characters) support keywords in DDS.

VNM (10) - Valid library name. Valid database name.

YIGCCNV

0Do not generate IGC support keywords 1Generate 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. VNM (10)Valid library name. Valid model language code; for example *ENG.

YMDLLIB YMDLLNG

Name of model library: must be the same as the library containing the model. National language for system portion of model.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

361

YCHGMDLVAL (Change Model Value) Command

Model Value YMDLTXT YOLDLIB YOPNACC

Description Text description of the model. Use in banner of generated code. Name of library into which old physical files are archived. Value defines whether concurrent access by *DSNR(s) and *PGMR(s) is allowed.

Allowed Values TEXT (30) Valid System Name

*YESAllow *DSNRs and *PGMRs in the model concurrently. *NODisallow concurrent *DSNR and *PGMR access. SQL Valid System name. *NONEThere is no SQL library associated with the model. *GENLIB, VNM(10)

YSQLLIB

Name of library in which to place the collection to implement the SQL database.

YTRGLIB

Specifies the name of the library into which model trigger references should be converted using the YCVTTRGDTA command. 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.

YTRNAPI

VNM(8)

Help Generation Values

Model Value YGENHLP Description 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. Allowed Values

*YESGenerate help text (UIM or TM) with all other HLLs. *NODo not generate help text. *ONLYGenerate help text only (without other HLLs).

362

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

Model Value YGUIHLP

Description 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.

Allowed Values

*NONEDo not generate GUI help. *WINGenerate GUI help using Windows help. *HTMLGenerate GUI help using HyperText Markup Language (HTML) for the Internet. *YESGenerate help text that is cursor sensitive. *NODo not generate cursor sensitive help text. *UIMGenerates help text in UIM (User Interface Manager) by default. *TMGenerates help text in TM (Text Management) by default.

YHLPCSR

Specifies whether to generate cursor sensitive text.

YNPTHLP

Determines what type of help text will be generated by default for NPT functions in the model.

Both are displayed using CA 2E utility. YUIMBID Tells the UIM generator whether to specify bidirectional support for UIM.

*NONENo bi-directional support for generated UIM panel groups. *LTRHelp is to be displayed with left-to-right orientation. *RTLHelp is to be displayed with right-to-left orientation. *AUTOFormat the narrative by default with a UIM Paragraph tag (:P). *FIXEDFormat the narrative by default with a UIM Lines tag (:L). *NONEDo not generate any references to a search index. *VLSPFXUse a name for the search index derived from the values list prefix.

YUIMFMT

Specifies the default formatting of narrative text, when included in generated UIM help.

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.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

363

YCHGMDLVAL (Change Model Value) Command

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 YWSNGEN *NPT YGENHLP *YES *NO *ONLY *GUI *YES *YES *NO *ONLY *NO *YES *NO *ONLY *ONLY *YES *NO *ONLY YGENGUI n/a

Source Components Generated NPT HLL yes yes --yes yes --yes yes --------NPT HELP yes --yes yes yes --------yes yes yes SDF ------yes --yes yes --yes ------Windows Help ------yes --yes ------yes --yes

364

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

PWS Environment Values

Model Value YGUIAKY Description 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. Allowed Values

*NODo not suppress generation of aid-keys description on the pull-down menu; in other words, display aid keys. *YESSuppress generation of aid-keys description. *NONENo descriptor text is used. text1,text2Up 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. valid system nameName of shared folder. This name defaults to the name of the model. *NONEThere is no folder. valid library nameA valid PC directory name. This will place all GUI functions into a single library. *AUTOLibrary 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.

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.

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. 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.

YGUILIB

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

365

YCHGMDLVAL (Change Model Value) Command

Model Value YGUILSO

Description Suppress List Options. Indicates whether subfileselect options should be displayed on the pulldown menu.

Allowed Values

*NODo not suppress display of subfile-select descriptions on the pull-down menu; in other words, display subfile-select descriptions. *YESSuppress display of subfile-select descriptions. *NONENo operator is used. text1,text2Up to two ways in which a command key or subfile selector value is separated from the text that describes it on your greenscreen device designs, separated by a comma; for example, =,-, ,--. Each value may be up to two characters. *NONENo descriptor text is used. text1,text2Up 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. *NOCommand keys are displayed once for the function, covering all tab dialogs. The command key text is taken from the first last detail screen. *YESCommand keys are displayed on each tab dialog. The command key text is taken from each detail screen.

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 5Display.

YGUISEL

Subfile Select Descriptor Text. Indicates how subfile selector text appears on your greenscreen device designs. You can specify up to two ways. The default is Opt as in Opt1-Select.

YGUITKY

Display command keys per tab. Indicates how command keys should be displayed on the nonNPT implementation of functions using tab dialogs; namely, Edit Record 2 and 3 and Display Record 2 and 3.

366

Command Reference Guide

YCHGMDLVAL (Change Model Value) Command

System Defaults
Model Value YSYSCHG Description Gives the default YCHGCTL model value for new models. Allowed Values

*NONERestricted exit programs are not called. Change control additional features are effectively off. Valid library name. *DDS *SQL *RPG *CBL *UIMGenerates help text in UIM by default. *TMGenerates help text in TM by default. *OFFThis model is incapable of generating message IDs for screen text literals. *MSGIDThis model will default to generate external message IDs for every screen text constant. *LITERALThis model is capable of generating external message IDs, but will not default to do so. You can override at a function level. *CUAENTRYDefaults to a header/footer without windows or action bars. *CUATEXTDefaults 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. *S38Defaults to System/38 style header/footer.

YSYSDBF

Defines system database access method, either DDS and HLL or SQL Data Definition Language (DDL) and Data Manipulation Language (DML). Default HLL given to new models. It is the value for YHLLGEN model value. Gives the default YNPTHLP on YCRTMDLLIB.

YSYSHLL

YSYSNPT

YSYSPMT

Defines system prompts.

YSYSSAA

Defines system default for SAA formatting option YSAAFMT.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

367

YCHKDTAMDL (Check Data Model) Command

Unchangeable Model Values

The following two tables show model values which cannot be changed with YCHGMDLVAL.

Protected Model Values

Model value YMDLLIB YMDLLVL YMDLNBR YMDLLNG YPMTNBR To change use this command YRNMMDL YAPYMDLCHG YAPYSYSMDL YAPYMDLTRN 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

Model Value YNLLMDL YSYSLNG Set By Install procedure Install procedure Role Defines the name of the null model. Defines the language of the installed product.

Example
To change the design standard to CUATEXT:
YCHGMDLVAL MDLVAL(YSAAFMT) + VALUE(*CUATEXT)

YCHKDTAMDL (Check Data Model) Command

Check data model is a process which reports on any integrity issues within a model.

368

Command Reference Guide

YCHKFUNACT (Check Function Action Diagram) Command

Any integrity issues found are listed on the spooled output. The messages indicate the surrogate numbers that are in error, as well as the file in which the errors were found. Contact Product Support if any errors are reported by the Check Data Model command. Optional
*MDLLIB YCHKDTAMDL MDLLIB model library name CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCHKDTAMDL command.

MDLLIB
Specifies the name of a CA 2E model to check for integrity. Values for this parameter are described in the following:

*MDLLIB(default) Special value meaning that the first model library in the library list is to be used. model library nameThe name of the model library over which an integrity check should be run.

Example
To examine objects in model library UURMDL for corruption:
YCHKDTAMDL MDLLIB(UURMDL)

YCHKFUNACT (Check Function Action Diagram) Command

This command allows a user to analyze the action diagram of a list of functions. Only functions that appear on the input model list are processed. A report provides details of any errors found. Functions that contain errors may optionally be added to an output model list.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

369

YCHKFUNACT (Check Function Action Diagram) Command

Required
*MDLPRF *MDLLIB/ YCHKFUNACT MDDLST model library *SELECT list name
*PRINT *NONE OPTION *EDIT *REFRESH
*REPLACE OUTLSTOPT *ADD CA 2E Modules: *ALL Job: B,I Pgm: B,I

*USER

OUTLST list name

Parameters
The following are parameters for the YCHKFUNACT command.

MDLLST
The qualified name of the model object list that contains the functions to be checked. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe model object list name must be entered. *MDLLIB(default) Special value meaning that the first model library found in the users current library list is used as the model library for the list. library nameThe model library name for the list.

option
Specifies the action to be taken if an error is found in an action diagram. Values for this parameter are described in the following:

*PRINT(default) The error is written to a report.

370

Command Reference Guide

YCHKJOBLE (Check Job List Entries) Command

*EDITThe action diagram of the function that has the error is to be edited. The program will position to the first offending action diagram block to allow the user to correct the problem. *REFRESHThe title of each action element of the action diagram is examined (they are calls to other function or messages). If the title is out of date, for example because the referenced function or message has been renamed, it is refreshed.

Outlst
The name of the model object list that receives output from the command. Values for this parameter are described in the following:

*NONE(default) Special value meaning that no outlist processing is to be performed. list nameThe model object list name is to be used as output.

outlstopt
This parameter specifies the action taken if the output list already exists. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list should be replaced with the output from this command. *ADDThe existing model object list should be augmented with the output from this command.

Example
To check the action diagrams of all functions contained in the model object list APLIST in the current model library and print a report of all errors found:
YCHKFUNACT MDLLST(*MDLLIB/APLIST)

YCHKJOBLE (Check Job List Entries) Command

Checks whether a source member or i OS object exists for each entry on a job list. Checks your authority to each i OS object found. You can also use the command to check your authority level to each i OS object found. If the object already exists, it is dropped from your job list.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

371

YCHKJOBLE (Check Job List Entries) Command

Optional
*MDDLIB/ *MDLPRF *MDLPRF/ *USER YCHKJOBLE JOBLST *CURLIB/ *WRKSTN *GENLIB/ list name library name/ *MDDLIB/ *RMVOK UPDLST *RMVERR *MDLPRF/ *CURLIB/ *GENLIB/ library name/

*NONE CHKGUI *GUIFLR

*NONE

*GENTYPE CHKFILE *LIB/ *CURLIB/ librarly name/

*NONE *CHANGE CHKAUT *ALL

*GENLIB/ file name

List the following: *OBJMGT *OBJEXIST *OBJOPR *READ *ADD *DLT *UPD
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCHKJOBLE command.

JOBLST
Qualified name of a job list where you place entries. Name of the job list whose entries are checked. Values for this parameter are described in the following:

*MDLPRF(default) The job list name is retrieved from the model profile details for the current user. *WRKSTNDefaults job name to job list name of invoking job.

372

Command Reference Guide

YCHKJOBLE (Check Job List Entries) Command

*MDLLIB/Defaults job list name to user profile name in model library.

UPDLST
List update option. Values for this parameter are described in the following:

*RMVOK(default) Remove verified items from list; that is, if the corresponding source member (CHKFILE parameter), i OS object (CHKLIB parameter), or specified authorities (CHKAUT parameter) are found. *RMVERRRemove items from list that are not verified.

CHKLIB
Name of the library to use when checking for the existence of i OS objects corresponding to each job list entry. Values for this parameter are described in the following:

*NONE(default) Do not check for any object's existence. *GENLIBCheck for objects in the generation library of the model (YGENLIB model value). *CURLIBCheck for objects in the current library. *LIBLUse the current job's library list.

CHKGUI
Name of shared folder to check for the existence of Synon/TC source objects corresponding to each job list entry. Values for this parameter are described in the following:

*NONE(default) Do not check for any objects existence. *GUIFLRCheck for objects in the Synon/TC shared folder of the model (YGUIFLR).

CHKFILE
Qualified source file name to check for the existence of a source member corresponding to each job list entry. Values for this parameter are described in the following:

*NONE(default) Do not check for a corresponding source member. *GENTYPEUse the default source file name as specified by the edit generation types display; for example, QRPGSRC for RPG III source, QCLSRC for CL source.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

373

YCHKMDL (Check Model) Command

CHKAUT
i OS authorities to check after checking for object or source member existence, as specified by the CHKLIB or CHKFILE. The value for this parameter is as follows:

*NONEDo not check for authorities when checking existence of corresponding source members or i OS objects.

For more information on i OS authority values, refer to the IBM CL Programmers guide.

Notes
The job list must already exist. Job lists are created using either the command Build Job List (YBLDJOBLST) or Convert Model List (YCVTMDLLST) from a command line, or by prompting the command from within a design model.

Example
To check for the existence of i OS objects in the generation library corresponding to the entries on job list MYJOBLST, removing all the entries for which a corresponding i OS object is found:
YCHKJOBLE UPDOPT(*RMVOK) + CHKLIB(*GENLIB) JOBLST(MYJOBLST)

YCHKMDL (Check Model) Command

This command checks your model for inactive internal records and unresolvable model object references. These can occur, for example, if a power outage results in an incomplete update or if a developer makes an error while using YWKRF to change model file data. The ACTION parameter lets you specify whether the internal files or the objects in your model are to be checked. It also lets you specify whether the command will run in prepass or update mode. All errors found are reported, and in update mode, inactive internal records are backed up to files in a library you specify before being deleted from the model. Note: If you need to restore data from a backup file, you should take great care to specify the correct member name. It will be the same as the name of your model library. When copying data back, be sure to specify *ADD for the MBROPT parameter on the Copy File (CPYF) command.

374

Command Reference Guide

YCHKMDL (Check Model) Command

Optional
YCHKMDL YCHKMDL MDLLIB model library name

*ANALYZE ACTION *UPDATE *PREPASS

*ADD (1) UPDOPT *REPLACE (1) TEXT

*MDLLIB (1) BAKLIB library name

*DFT

member name

(1) BAKLIB, UPDOPT, and TEXT are prompted only when ACTION is set to *UPDATE.

CA 2E Modules: *ALL

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCHKMDL command.

MDLLIB
The name of the model to be analyzed. Values for this parameter are described in the following:

*MDLLIB(default) Special value indicating the model library is the first one in the current library list. model library nameThe name of the model to be analyzed may be entered explicitly.

ACTION
Specifies the type of check to perform and whether to run in prepass or update mode. A report is produced listing any data in error. Values for this parameter are described in the following:

*ANALYZE(default) The command checks each object in the model and all objects that use the object (usages) and all objects that it refers to (references). This can be a lengthy process for large models. No update is performed.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

375

YCHKMDL (Check Model) Command

This option produces a separate report that shows any unresolvable references that are encountered during the expansion of a given object; for example, if a model object refers to an object that has been deleted from the model. If the report shows any errors, first attempt to remove them using *UPDATE and run the *ANALYZE analysis again. If there are any entries remaining after running the second analysis, please contact your local product support representative who will assist you with their removal.

*PREPASSThe command analyzes those internal files that can automatically be updated in *UPDATE mode and reports any inactive records. No actual update is performed. *UPDATEThe command performs the same analysis as in the *PREPASS mode, and also deletes inactive records from the internal files.

BAKLIB
The name of the library that is to receive backup data. The data is written to a file that has a name similar to that of the originating file; the member name is the same as the name of your model library. For example, an inactive record in the YSCRENTRFP file (screen or report device entries) in model library MYMODEL, would be written to file YSCRENTXXP and member MYMODEL in the backup library. You can therefore specify a single backup library to store all deleted data from all the models on the system. This parameter is prompted only in *UPDATE mode. Values for this parameter are described in the following:

*MDLLIB(default) Special value indicating the model library is to be the backup library. library nameThe name of the backup library may be entered explicitly.

UPDOPT
This parameter specifies whether new data written to the backup members should replace or be added to existing data. This parameter is prompted only in *UPDATE mode. Values for this parameter are described in the following:

*ADD(default) Special value indicating that the new data should be added to any existing data in the backup members. *REPLACEThe existing data should be cleared during processing.

376

Command Reference Guide

YCHKMDL (Check Model) Command

TEXT
The text to be attached to any new members added to the backup files. This parameter is prompted only in *UPDATE mode. Values for this parameter are described in the following:

*DFT(default) Special value indicating that a standard message will be used as new member text. member textThe user may specify the text to be used when adding new members to the backup files.

Example
To examine internal files in model library GR5MDL and to produce a report without updating data:
YCHKMDL MDLLIB(GR5MDL) ACTION(*PREPASS)

Additional Processing
YCHKMDL processing now includes some additional processing to provide feedback on the progress of YCHKMDL.

If the job is running interactively, a message is sent to the screen to indicate the current object being processed and the percentage complete. For example: Processing Object 837 of 2476. 33% Completed.

If the job is running interactively or in batch, a message is sent to the joblog to indicate the total number of objects to be processed, and a message is sent when every 10% block is reached. For example:
Total number of objects to process: 2476 Processing Object 1 of 2476. 0% Completed. Processing Object 248 of 2476. 10% Completed. Processing Object 496 of 2476. 20% Completed. Processing Object 743 of 2476. 30% Completed. Processing Object 991 of 2476. 40% Completed. Processing Object 1238 of 2476. 50% Completed. Processing Object 1486 of 2476. 60% Completed. Processing Object 1734 of 2476. 70% Completed. Processing Object 1981 of 2476. 80% Completed. Processing Object 2229 of 2476. 90% Completed. Processing Object 2476 of 2476. 100% Completed.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

377

YCHKMDLLST (Check a Model Object List) Command

YCHKMDLLST (Check a Model Object List) Command

This command allows a user to simultaneously check model object list entries and to remove certain, unwanted entries. The command also allows entry details to be refreshed from the originating object. An outlist capability allows users to filter entries to an alternative list leaving the input list unchanged by the filtering process. In other words, if you specify an output list, the input list will not be updated.

378

Command Reference Guide

YCHKMDLLST (Check a Model Object List) Command

Optional

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

379

YCHKMDLLST (Check a Model Object List) Command

*MDLPRF *MDLLIB/ *USER YCHKMDLLST MDLLST *SELECT model library/ list name

*BYSGT CHKTYPE byname

*RFSALL *RFSSGT *FLAGERR UPDLIST *FLAGOK *RMVERR *RMVOK max 3

*ANY FLAGVAL *ERROR *SELECTED *MDLLIB CHKMDL model name *ANY CUROBJ *YES
*ANY *MDLLST CHKLST *MDLPRF *USER list name

*ANY CHKSTS *NONE status value max 5

*NONE CHKMDLLCK *YES

*NONE OUTFLAGVAL *ERROR *SELECTED

380

Command Reference Guide

YCHKMDLLST (Check a Model Object List) Command

*NONE *REPLACE *MDLPRF OUTLST *USER *ADD list name

CA 2E Modules: *ALL Job: I,B Pgm: I,B

OUTLSTOPT

Parameters
The following are parameters for the YCHKMDLLST command.

MDLLST
The qualified name of the model object list that is checked. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the model profile details for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe name of the list. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used. library nameThe name of the model library.

CHKTYPE
Check list entry method. Values for this parameter are described in the following:

*BYSGT(default) The list entries are checked by object surrogate number. *BYNAMEThe list entries are checked by object name.

UPDLST
List update option. Values for this parameter are described in the following:

*RFSALL(default) The data contained in each list entry are refreshed from the corresponding model object details.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

381

YCHKMDLLST (Check a Model Object List) Command

*RFSSGTOnly the surrogate number of each list entry is refreshed from the corresponding model object details. The CHKTYPE parameter must be *BYNAME for this option. *FLAGERRIf an error occurs during processing of a list entry, the entry is flagged. The value to use is specified by the OUTFLAGVAL parameter. This value may be the subject of a later filtering operation. Note that if entries are flagged, then the OUTFLAGVAL parameter must be set to the desired value. *FLAGOKIf an error does not occur during processing of a list entry, the entry is flagged. The value to use is specified by the OUTFLAGVAL parameter. This value may be the subject of a later filtering operation. *RMVERRIf an error occurs during processing of a list entry, the entry is removed from the list. *RMVOKIf the processing of a list entry completes without error, the entry is removed from the list. Note: The updating of model lists is controlled by the UPDLST parameter. For example, it must specify *RMVERR if invalid entries are deleted from the input list or omitted from copy to the output list. Users should also note that the flagging of entries occurs if the UPDLST parameter instructs the program to do so. However, the appropriate value to use should be specified in the OUTFLAGVAL parameter to avoid the default value of blank. When an output list is specified the input list is not updated. If *RMVERR is specified together with an output list, it has the effect of not copying input list entries to the output list. Such entries are not removed if they already exist on the output list.

FLAGVAL
This parameter allows model object list entries to be filtered by the model object list entry flag value. Values for this parameter are described in the following:

*ANY(default) No filtering on flag value is to be performed. *ERROROnly entries flagged as being in error satisfy the filter. Other entries are ignored. *SELECTEDOnly explicitly selected model objects satisfy the filter. Other entries are ignored.

CHKMDL
Check model library name. This parameter enables objects from one model to be checked against objects of the same name in another model. Values for this parameter are described in the following:

382

Command Reference Guide

YCHKMDLLST (Check a Model Object List) Command

*MDLLIB(default) The list entries are checked against objects in the same model. model nameThe model that entries are checked against.

CUROBJ
This parameter identifies whether the objects on the list are current. Values for this parameter are described in the following:

*ANY(default) Objects are not checked. *YESOnly current objects satisfy the check.

CHKLST
The checked out to list may be examined with this parameter. Values for this parameter are described in the following:

*ANY(default) Any value for checked out to list is acceptable. *MDLLSTList entries must be checked out to the current list. *MDLPRFList entries must be checked out to the model object list specified on the current user's model profile. *USEREntries must be checked out to the model list that has the same name as the current user. list nameA list name may be specified.

CHKSTS
The check out status of list entries may be checked. Values for this parameter are described in the following:

*ANY(default) Check out status is not examined. *NONESpecial value meaning that entries should have no value for check out status. status valueUser-defined value. Up to five values may be specified for check out status.

CHKMDLLCK
This parameter allows the lock status of each object on the list to be examined. Values for this parameter are described in the following:

*NONE(default) No examination of object locks is made. *YESObjects on the list must not be locked.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

383

YCHKMDLLST (Check a Model Object List) Command

OUTFLAGVAL
This parameter specifies the value used in combination with the UPDLST parameter. Selected list entries are updated with this value if UPDLST is specified as *FLAGERR or *FLAGOK. Values for this parameter are described in the following:

*NONE(default) No updating of the flag value is performed. *ERROREntries which satisfy the filtering criteria are flagged as *ERROR if UPDLST is specified as *FLAGERR or *FLAGOK. *SELECTEDEntries that satisfy the filtering criteria are flagged as selected if UPDLST is specified as *FLAGERR or *FLAGOK.

OUTLST
The name of the model object list which is the target for entries that satisfy any filter. Values for this parameter are described in the following:

*NONE(default) Special value meaning that no outlist processing is performed. *MDLPRFSpecial value meaning that the model object list name is retrieved from the model profile record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name. list nameThe name of the target list.

OUTLSTOPT
This parameter specifies the action taken if the outlist specified in the OUTLST parameter already exists in the model. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list is replaced with the output from this command. *ADDThe existing model object list is augmented with the output from this command.

Notes

The input model object list must already exist prior to running this command.

384

Command Reference Guide

YCHKMDLOBJ (Check Existence of Model Object) Command

A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. If an error is detected during processing of the list entries, a diagnostic message is sent for each error encountered, and an escape message is sent at the end of processing. When using this command in CL programs, users may monitor for the escape message which is sent. The message id for this message is Y2E0328. The OUTLSTOPT parameter is ignored if *NONE is specified for OUTLST. If the specified OUTLST does not exist prior to running this command, it is created. If the CHKMDL parameter is specified (i.e., other than *NONE) then the CHKTYP must specify *BYSGT, since it is not possible to compare objects between models by surrogate key number.

Example
To refresh model object list OLDLST so that all the list entries are completely up to date:
YCHKMDLLST MDLLST( *MDLLIB/OLDLST ) + UPDLST( *RFSALL )

To check model object list FUNLST to determine that all objects on the list still exist in the model:
YCHKMDLLST MDLLST( *MDLLIB/FUNLST ) + UPDLST( *RMVERR )

Using the *RMVERR option for UPDLST will ensure that only valid objects remain on the list.

YCHKMDLOBJ (Check Existence of Model Object) Command

This command provides the means by which the existence of an object may be established. Objects may be identified by name or by implementation name.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

385

YCHKMDLOBJ (Check Existence of Model Object) Command

Required
*SRCMBR *NONE YCHKMDLOBJ OBJNAM *ARRAYS *MESSAGES owner name *APP *ARR *CND *FIL *FLD *FUN *MSG *OBJNAM SRCMBR source member name *ANY *PGM *FILE *HLPTXT *ACP

*MDLLIB/ MDLLIB model library/

RTNOBJSGT
CA 2E Modules: *ALL

CL

variable name
Job: I,B Pgm: I,B

Parameters
The following are parameters for the YCHKMDLOBJ command.

OBJNAM
The object name of the object whose existence is checked. This parameter consists of three elements which together identify a model object. Values for this parameter are described in the following:

*SRCMBR(default) Single value indicating that the object implementation name (source member) is used to identify the model object to be checked. object owner nameThe character name of the object which owns the object to be checked. Thus, for a function, the owning file would be entered. *NONESpecial value indicating that the object concerned does not have an owner (such as objects of type *FIL). *ARRAYSSpecial value for the product internal file *ARRAYS. *MESSAGESSpecial value for the product internal file *MESSAGES.

386

Command Reference Guide

YCHKMDLOBJ (Check Existence of Model Object) Command

object nameThe character name of the object to be checked. object typeThe object type of the object. *ACPObject is of type access path. *APPObject is of type application area. *ARRObject is of type array. *CNDObject is of type condition. *FILObject is of type file. *FLDObject is of type field. *FUNObject is of type function. *MSGObject is of type message.

SRCMBR
The source member implementation name of the model object whose existence is checked. Values for this parameter are described in the following:

*OBJNAM(default) Use object name to identify the model object to be checked. source member nameThe source member name of the model object. implementation object typeThe type of object created by the source member. This value may be required to distinguish between objects that have the same implementation name, such as a display file in a model that has the same name as a program. *ANY(default) The object type is unspecified. *PGMThe object is a program. *FILEThe object is an access path, display file or print file. *HLPTXTThe object is a help text file.

MDLLIB
This parameter allows the user to specify the model library in which to find the object. Values for this parameter are described in the following:

*MDLLIB(default) Use the first model library in the job's current library list. model libraryThe name of the model library to use.

Chapter 3: Commands (YADDMDLLE - YCHKMDLOBJ)

387

YCHKMDLOBJ (Check Existence of Model Object) Command

RTNOBJSGT
CL variable that is to receive the surrogate key of the object. Decimal variable, seven digits packed.

Notes

A search is made for the model object in the first model library found in the library list. If the object is found, the command completes normally. If the object is not found, an exception message (Y2EO311) is sent. If the object being checked is not a primary object (such as the display file or help file for a panel based function), the surrogate number of the owning object is returned. Thus, for a display file auxiliary object, the function surrogate number would be returned.

Example
To check whether the function Edit Order version 2 exists in the model, enter the following command:
YCHKMDLOBJ OBJNAM( 'Order' 'Edit Order + version 2' *FUN )

To check whether the function UUG2EFR exists in data model DEVMDL, and, if it does, to receive the corresponding object surrogate key number in parameter &OBJSGT:
YCHKMDLOBJ SRCMBR( UUG2EFR ) + MDLLIB(DEVMDL) RTNOBJSGT( &OBJSGT )

388

Command Reference Guide

Chapter 4: Commands (YCLRMDL YDLTOBJTBL)

This chapter contains details for CA 2E commands YCLRMDL through YDLTMDLVSN. These commands appear in alphabetical order and include descriptions of their functions, parameters and allowed values, notes, and examples. Each command is also accompanied by a command diagram.

YCLRMDL (Clear Model) Command

Clears a model. All user-defined data is dropped leaving a copy of the null model data but retaining your existing model values.

Required
*CURLIB YCLRMDL MDLLIB library name

Optional
*NONE *NONE *GENLIB GENLIB *CURLIB library name library name
CA 2E Modules: *ALL Job: I,B Pgm: I,B

SQLLIB

*SQLLIB

Parameters
The following are parameters for the YCLRMDL command.

MDLLIB
Library containing a design model you want to clear. The value for this parameter is as follows:

*CURLIBUse current library for invoking job.

Error! No text of specified style in document.

41

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

GENLIB
Library containing generated source to be cleared. Values for this parameter are described in the following:

*NONE(default) Do not clear the generation library. *GENLIBClear the generation library whose name is given by the YGENLIB model value. *CURLIBUse current library for invoking job.

SQLLIB
Library containing the SQL collection to be cleared. Values for this parameter are described in the following:

*NONE(default) Do not clear the collection library. *SQLLIBClear the library containing the SQL collection given by the YSQLLIB model value.

Notes

When you clear a model, the CA 2E null model (Y2SYMDL) must be present. If you specify a library name for the GENLIB parameter, all programs and files in the library beginning with the system prefix are deleted (except those beginning with Q). Model profiles are not cleared by the YCLRMDL command. To clear model profiles, you should clear file YMDLPRFRFP in the model.

Example
To clear model MYMDL, but not the generation library, enter:
YCLRMDL MDLLIB(MYMDL)

YCLRMDLLST (Clear a Model Object List) Command

This command clears the entries on a model object list.

42

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Optional
*MDLPRF *MDLLIB/ YCLRMDLLST MDLLST model library/ *SELECT list name
CA 2E Modules: *ALL Job: I Pgm: B,I

*USER

Parameters
The following are parameters for the YCLRMDLLST command.

MDLLST
The qualified name of the model object list that is to be cleared. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe model object list name can be entered. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library for the list. library nameModel library name for the list.

Example
To clear entries from model object list LST001 from the model contained in the current library list:
YCLRMDLLST MDLLST( *MDLLIB/LST001 )

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

43

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

YCMPMDLOBJ (Compare Model Objects) Command

This command provides the means by which two model objects may be compared. This facility would be required, for instance, to identify changes made to one version of an object for retrofitting to another version. For example, you could use this command to identify the differences between versions of a model object. Objects may be identified by name or by object surrogate number. At present, you can compare functions, messages or files (FIL) only.

Required
*OBJSGT1 YCMPMDLOBJ OBJNAM1 owner name object name *MESSAGES
*OBJNAM1 OBJSGT1 model object surrogate
*MDLLIB MDLLIB1 model library name

*FUN *MSG

*OBJSGT2 OBJNAM2 *OBJNAM1 *MESSAGES owner name

*OBJNAM2 *PRD OBJSGT2 *SELECT model object surrogate

object name

*OBJNAM1

MDLLIB1 MDLLIB2 model library name

44

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Optional
*NO IGNCASE *YES 3 MATCHSIZE number of lines 1 PRTBEFORE number of lines 1 PRTAFTER number of lines
*LIST PRTDFFOPT *NOLIST
CA 2E Modules: *ALL Job: B,I Pgm: B,I

*NO PRTHDRS *YES

Parameters
The following are parameters for the YCMPMDLOBJ command.

OBJNAM1
The first object name of the two objects which are to be compared. This parameter consists of three elements which together identify a model object. Values for this parameter are described in the following:

*OBJSGT1(default) Single value indicating that the first object surrogate number parameter is to be used to identify the model object to be compared. object owner nameThe character name of the object which owns the object to be compared. Thus, for a function, the owning file would be entered. *MESSAGESThe internal file *Messages is the owner of the object (note that this value is only allowed for objects of type *MSG). object nameThe character name of the object to be compared. object typeThe object type of the object. *FUNObject is of type function. *MSGObject is of type message.

OBJSGT1
Unique number identifier of the first model object that is compared. Values for this parameter are described in the following:

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

45

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*OBJNAM1(default) Use the first object name parameter details to identify the first model object. object surrogateThe surrogate number of the first model object.

MDLLIB1
This parameter identifies the model in which the first object resides. Values for this parameter are described in the following:

*MDLLIB(default) Special value indicating that the first model in the library list is used. model nameThe name of the model.

OBJNAM2
The name of the second object that is compared. This parameter consists of three elements which together identify a model object. Values for this parameter are described in the following:

*OBJSGT2(default) Single value indicating that the second object surrogate number parameter is used to identify the model object to be compared. object owner nameThe character name of the object that owns the second object to be compared. *MESSAGESThe internal file *Messages is the owner of the object (note that this value is only allowed for objects of type *MSG). *OBJNAM1(default) Special value indicating that the second object name is the same as the first object name. object nameThe character name of the object to be compared. *OBJNAM1(default) Special value indicating that the second object type is the same as the first object type. This is a required value. That is, the comparison of different object types is not supported.

OBJSGT2
Unique number identifier of the second model object to be compared. Values for this parameter are described in the following:

*OBJNAM2(default) Use the second object name parameter details to identify the second model object. *PRDUse the surrogate number of the production version of the group to which OBJSGT1 belongs. *SELECTInvoke a selection program so you can select a version from the group to which OBJSGT1 belongs.

46

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

object surrogateThe surrogate number of the second model object.

MDLLIB2
This parameter identifies the model in which the second object resides. Values for this parameter are described in the following:

*MDLLIB1(default) Special value meaning that the model is the same as that specified on the MDLLIB1 parameter. model nameThe name of the model.

IGNCASE
Case sensitivity option. Values for this parameter are described in the following:

*NO(default) Treat upper and lower case text as different when comparing object details. *YESIgnore any differences between text which is the result of a case difference only. For example, the character x will match with X.

PRTHDRS
This parameter controls the printing of headings and action diagram user points during processing. Values for this parameter are described in the following:

*NO(default) Headings will not be printed. If there are no differences between the two objects compared, no spool file will be produced. *YESHeadings will be printed. A spool file will be produced even if there are no significant differences between the two objects. The forced printing of headings is useful when there is a difference between two large action diagrams as it identifies the user point in which the difference occurs.

MATCHSIZE
The number of lines required for a match. The value for this parameter is as follows:

3(default) Three lines must match.

PRTBEFORE
The number of preceding lines to be printed when a mismatch is encountered. The value for this parameter is as follows:

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

47

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

1(default) One line is to be printed before the mismatch.

PRTAFTER
The number of following lines to be printed when a mismatch is encountered. The value for this parameter is as follows:

1(default) One line is to be printed after the mismatch.

PRTDFFOPT
Indicates whether differences are to be reported. Values for this parameter are described in the following:

*LIST(default) Print the mismatched lines. *NOLISTNo mismatch details are to be reported. Simply indicate whether or not the objects match.

Notes

Each object must exist in the specified model(s) prior to running the command. If the two objects are found to differ, an exception message is returned to notify the user. Model objects can either be identified by object name (OBJNAM) or by object surrogate key number (OBJSGT). If the OBJNAM parameter is used, the processing program must convert to surrogate key number internally. Thus, it will normally be more efficient to use the surrogate number if this value is available. The surrogate number for an object can be obtained using the Retrieve Model Object command (YRTVMDLOBJ). Users of this command should note that when applied to a function which has an action diagram, commented code is not ignored.

Example
To check whether the function Display Vehicle Dtls #1 differs from Display Vehicle Dtls #2, ignoring any case differences in the object definitions, enter the following command:
YCMPMDLOBJ OBJNAM1( 'Vehicle' 'Display + Vehicle Dtls #1' *FUN ) OBJNAM2( *OBJNAM1 + 'Display Vehicle Dtls #2' *OBJNAM1 ) + IGNCASE( *YES )

48

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

YCPYMDL (Copy Model) Command

Copies an entire model library to a new model or to an existing model.

Required
library name YCPYMDL FROMMDLLIB *CURLIB TOMDLLIB *CURLIB library name

Optional
*ADD MDLOPT *REPLACE
CA 2E Modules: *ALL

*YES CRTMDL *NO

Job: I,B Pgm: I,B

Parameters
The following are parameters for the YCPYMDL command.

FROMMDLLIB
Name of design model you want to copy. Must be a model library. The value for this parameter is as follows:

*CURLIBUse current library for invoking job.

TOMDLLIB
Name of model library to which the model is to be copied. If the name of an existing library is specified, then it must be a valid design model; that is, it must have been created with the YCRTMDLLIB command. The value for this parameter is as follows:

*CURLIBUse current library for invoking job.

MDLOPT
Model copy option. Values for this parameter are described in the following:

*ADD(default) Add to the contents of a new model. This option is only allowed if *YES is specified for the CRTMDL parameter.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

49

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*REPLACEReplace any existing contents of the model named by the TOMDLLIB parameter.

CRTMDL
Model create option. Values for this parameter are described in the following:

*YES(default) If the model specified by the TOMDLLIB parameter does not exist, create it. *NOIf the model specified by the TOMDLLIB parameter does not exist, do not copy the model.

Notes

You cannot copy a model while it is in use. The YCPYMDL command does not create a CA 2E generation library. If you have created a model using the CRTMDL(*YES) parameter of YCPYMDL, you will need to create the generation library yourself. To create a generation library:
YCRTMDLLIB MDLLIB(*NONE) GENLIB(NEWGEN)

If you wish to copy objects from the generation library of the copied model:
YCRTDUPOBJ OBJ (*ALL) + FROMLIB (old generation library) + OBJTYPE (*ALL) + TOLIB (new generation library) + DATA (*YES) CRTOPT (*ALL)

The YCPYMDL and YCRTDUPOBJ commands leave your new model library with settings from your old model for some of the Environment model values. For example:

YGENLIGeneration Library YSQLLIBSQL Collection Library YCPYLIBCopy Library YOLDLIBOld Library YCMPTXTCompany Text

Use the YCHGMDLVAL command to change the settings of these model values in your new model as needed. For more information on the Environment model values, refer to this chapter, the YCHGMDLVAL command.

410

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Example
To copy library MYOLDMDL to MYNEWMDL, creating a new model:
YCPYMDL FROMMDLLIB(MYOLDMDL) + TOMDLLIB(MYNEWMDL) CRTMDL(*YES) YCRTMDLLIB MDLLIB(*NONE) GENLIB(MYNEWGEN)+ SYSTEXT(My new model) YWRKLIBLST LIBLST(MYNEWMDL)

Add the generation library name to the list. Save the library list and the job description on exit.
YCHGMDLVAL MDLVAL(model value name) + VALUE(new value)

If needed, update Environment model values for the new model.

YCPYMDLLST (Copy Model Object List) Command

This command allows the user to copy from one model object list to another. It is also possible to copy from one data model to another. If the target list exists prior to the copy it can be replaced or appended to. At the time of the copy, list entries can be refreshed in the target list and optionally flagged for further processing.

Required
model object list name *MDLLIB/ YCPYMDLLST FRMMDLLST model library name *USER *SELECT *MDLPRF

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

411

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Optional
*MDLPRF *FRMMDLLIB TOMDLLST model library name model object list name *USER

*REPLACE LSTOPT *ADD *NONE TOUPDOPT *RFSALL *RFSSGT

*ANY FLAGVAL *ERROR *SELECTED
CA 2E Modules: *ALL Job: I,B Pgm: I,B

Parameters
The following are parameters for the YCPYMDLLST command.

FRMMDLLST
The qualified name of the list that is copied. Values for this parameter are described in the following:

list nameThe name of the list to copy. *MDLPRFSpecial value meaning that the name of the list is obtained from the model profile details of the current user. *USERSpecial value indicating that the list to copy has the same name as the current user. *SELECTSpecial value meaning that the list to copy is selected from an interactive display. *MDLLIB(default) Special value meaning that the first model library in the library list is used. model library nameThe name of the model library may be entered.

TOMDLLST
The qualified name of the list that is the target of the copy operation. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the name of the list is obtained from the model profile details of the current user.

412

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*USERSpecial value indicating that the list to copy has the same name as the current user. list nameThe name of the target list. *FRMMDLLIB(default) Special value meaning that the target model object list exists or should be created in the same data model library as the list to copy. model library nameThe name of the target model object list model library.

LSTOPT
This parameter specifies the action to be taken if the list already exists in the model. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list is replaced with the output from this command. *ADDThe existing model object list is augmented with the output from this command.

TOUPDOPT
To list update option. Values for this parameter are described in the following:

*NONE(default) No updates are made to the output list entries. This value is only valid if the target model library is the same as the source model library. *RFSALLThe data contained in each list entry are refreshed from the corresponding model object details in the target model. *RFSSGTThe surrogate number of each list entry is refreshed from the corresponding model object details.

FLAGVAL
Specifies the flag value of entries processed from the input list during the copy. Values for this parameter are described in the following:

*ANY(default) No record selection is performed. *SELECTEDOnly entries flagged as being selected are processed. *ERROROnly entries flagged in error are processed.

Notes

The library for the input list must be a valid model library.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

413

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

A value other than *MDLLIB for FRMMDLLST may result in the library list being changed during execution of the command. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. The FRMMDLLST must exist prior to running the command. The target list will be created if it does not already exist. The LSTOPT parameter will be ignored if the target list does not already exist. The refreshing of list entries is always by name. That is, the details for each entry are ascertained by attempting to find the object by name in the model object file of the target model. If the object cannot be found, the entry in the input list is flagged in error and the object is not copied to the target list. If the object already exists in the target list, no action is taken to refresh the entry. The refresh surrogate number option (*RFSSGT) refreshes the surrogate number, object type, object attribute, owner surrogate and owner name of the new object entry in the target list. The completion message for this command includes a count of the number of records that already existed in the target list, the number of records copied and the number of errors, where objects from the input list could not be found in the target model. If any errors were encountered, a diagnostic is sent for each one indicating the reason for the error and at the end of processing an escape message is sent, for which developers may monitor.

Example
To copy model object list WRKLST from the model contained in the current library list to a model object list with the same name as the current user:
YCPYMDLLST FRMMDLLST(*MDLLIB/WRKLST) + TOMDLLST(*MDLLIB/*USER)

LSTOPT(*REPLACE)

YCPYMDLOBJ (Copy Model Objects) Command

Copies selected objects from one model to another model. The objects to copy are specified on a model list. These objects must be flagged explicitly on the list. To do this, you may use any of the following commands:

Edit Model Object List for Copy (YEDTCPYLST)

414

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Build a Model Object List (YBLDMDLLST) Change a Model Object List Entry (YCHGMDLLE) Add a Model Object List Entry (YADDMDLLE)

Required
*CURLIB YCPYMDLOBJ FRMMDLLIB model library name TOMDLLIB library name *CURLIB

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

415

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Optional
*PREPASS CPYOPT *COPY
*YES *NO CPYTXT *OPR *FUN *DBF *INT CPYSUBFUN *ALL *NONE CPYCND *SELECTED *ALL

*YES CPYNM *NO

*REJECT MAPDUP *GENERATE

*MDLPRF *SELECT CPYLST *USER model object list name

*CURRENT MAPVSN *FIRST

*MDLVAL TGTGENLIB *NONE library name

*NEXT ROBPFX *NONE list of reserved file prefixes *ANY SEVFLT *ERROR severity filter 0-30
*NONE (2) MDLLCK *BYOBJECT *MODEL (3) ERRLVL *NOMAX error level

(1) EXPRQDOBJ

*NO *YES

1. 2. 3.

EXPRQDOBJ is prompted when CPYSUBFUN is not set to *ALL. MDLLCK is prompted when CPYOPT is set to *COPY. ERRLVL is prompted when MDLLCK is set to *BYOBJECT.

CA 2E Modules: *ALL

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCPYMDLOBJ command.

416

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

FROMMDLLIB
Name of design model from which objects are copied. You must have previously built and edited a model list in this library. The value for this parameter is as follows:

*CURLIBUse current library for invoking job.

TOMDLLIB
Name of model library to which objects are copied. It must be a valid design model that has been created with the YCRTMDLLIB or YCPYMDL commands. The value for this parameter is as follows:

*CURLIBUse current library for invoking job.

CPYOPT
Model copy option. Values for this parameter are described in the following:

*PREPASS(default) Check the objects to be copied against the objects in the target model named by the TOMDLLIB parameter. Produce a report of any discrepancies found. Do not actually copy objects. *COPYCopy the objects in the list to the model named by the TOMDLLIB parameter. Produce a report of any alterations that have to be made to the target model.

CPYVNM
Specifies whether the implementation name of an object should be copied. Only applies when the object being copied already exists in the target model; implementation details will always be copied for objects new to the target model. Values for this parameter are described in the following:

*YES(default) When copying object details, also copy any implementation names associated with the object (member names, DDS format names, DDS field names, or SQL column names). *NOWhen copying object details, do not copy any implementation names associated with the object. Use the names from the existing objects in the target model.

CPYTXT
Specifies whether narrative text associated with a CA 2E object should be copied. Values for this parameter are described in the following:

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

417

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*YES(default) When copying object details, also copy any narrative text associated with the object. *OPRCopy only any operational text. *FUNCopy only any functional text. *NOWhen copying object details, do not copy any narrative text associated with the object.

CPYCND
This parameter determines which conditions are included in the analysis. Explicitly selected conditions will be copied and will overwrite the same condition in the target model. All new condition which are included in the analysis will be copied to the target model. Values for this parameter are described in the following:

*ALL(default) The copy process will examine all conditions even if they are not going to be copied. *SELECTEDOnly conditions that are explicitly or implicitly selected will be included in the analysis. Implicit conditions are those, for example, that appear on an explicitly selected list condition.

CPYSUBFUN
Specifies whether and which subordinate functions called by a CA 2E function should be copied when the function is copied. Implicit selections are copied only if they do not exist in the target model. To replace existing subordinate functions in the target model, you must explicitly select them on the model list. Note that this parameter affects the expansion of explicitly selected objects. If an object that does not qualify for expansion is encountered, and it does not exist in the target model, processing cannot continue past the prepass stage. See the EXPRQDOBJ parameter and the Notes section for more details. Values for this parameter are described in the following:

*DBF(default) When copying a function, also copy any database functions (for example, CRTOBJ, CHGOBJ) called by the function. *INTWhen copying a function, also copy all internal functions (for example, EXCINTFUN) called by the function. *ALLCopy all subordinate functions called by the function. *NONEDo not copy any subordinate functions called by the function.

418

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

MAPDUP
While attempting to allocate object names in the target model it is possible duplicate names will be encountered. This parameter determines what action is taken in that situation. Values for this parameter are described in the following:

*REJECT(default) The duplicate name will be reported in the prepass report and the copy process will not be attempted. *GENERATEA new name is automatically generated for any object found with a duplicate name in the target. This name will be a combination of the source model object name and the assigned target surrogate number. This action will be reported in the prepass report before any renaming occurs in the target model.

MAPVSN
This parameter is used while identifying which version for a versionable object should be replaced in the target model. Values for this parameter are described in the following:

*CURRENT(default) The current version of all objects found in the target model will be replaced during the copy process. If there is no current version for an object then the copy will replace the *FIRST version for the group. See the description of the *FIRST parameter value. *FIRSTThe first version encountered chronologically in the target model will be replaced by the copy process. This will generally be the oldest version in a group.

CPYLST
This parameter specifies the model object list that lists the objects to copy to the target model. Values for this parameter are described in the following:

*MDLPRF(default) The list name is retrieved from the model profile for the current user. *SELECTAn interactive program is called from which you can select a model object list. *USERThe list name is the same as the current user name. list nameThe name of a specific model object list.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

419

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

TGTGENLIB
This parameter specifies the generation library associated with the target model that receives the source for function types Execute User Program or Execute User Source which are included in the copy process. Values for this parameter are described in the following:

*MDLVAL(default) Use the default generation library name for the target model. *NONENo source is copied to the target model. library nameThe name of the library to receive source.

ROBPFX
Specifies allocation of reserved object prefixes for files when the basic limit (AA-T9) has been exceeded. Values for this parameter are described in the following:

*NEXT(default) Use available system prefixes (UU and up). *NONENo allocation. list of reserved file prefixesString of up to 5 two-character values can be specified to be used as reserved prefixes for files.

SEVFLT
Specifies the lowest message severity to be printed on the prepass report. Note: You can change the default value for the YCPYMDLOBJ messages by first duplicating them out into a separate message file and then changing their message severity. If this is do, remember that messages shipped with a severity of 30 are deemed to be *Error messages. Values for this parameter are described in the following:

*ANY(default) Print all messages. This is equivalent to entering a severity filter of 0. *ERROROnly print error messages on the prepass report. This is equivalent to entering a severity filter of 30. severity filterA value from 0 to 30. Only messages with a severity greater than or equal to this value will be printed on the prepass report.

420

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

EXPRQDOBJ
This parameter is prompted when the Copy subfunctions parameter (CPYSUBFUN) is other than *ALL. It lets you specify the action to be taken when a function excluded by CPYSUBFUN does not exist in the target model. This is needed to prevent corruption of the target model or abnormal termination of the YCPYMDLOBJ command. Refer to the Notes section for details. Values for this parameter are described in the following:

*NO(default) Stop processing and send a message identifying the function that does not exist in the target model. You can then choose to take action to correct the problem; for example, you can explicitly select the excluded function for copy. You should specify *NO if you do not want unexpected objects copied to the target model. *YESExpand references for the function and then continue normal processing. The function and any implicitly required objects that do not exist in the target model are copied. A report is produced to notify you of this action. This value effectively overrides the CPYSUBFUN parameter on an object by object basis. Specifying *YES improves the performance of YCPYMDLOBJ since subfunctions are only expanded when necessary. However, this can cause unexpected objects to be included in the copy. One solution is to run *YES in *PREPASS mode so you can examine any objects that were included unexpectedly before they are actually copied to the target model.

MDLLCK
This parameter specifies how the source model is to be locked during the copy operation. Only prompted if the CPYOPT parameter is set to *COPY. Values for this parameter are described in the following:

*BYOBJECT(default) The source model is placed in a shared lock state and all objects explicitly or implicitly required are also placed in a shared lock state. Using this option avoids locking the model during the copy process, however, locking objects individually involves extra processing. All objects must be available for processing to succeed, thus, the copy process will stop if any object cannot be locked. Since only a read lock is placed on required objects, it will be possible to share objects while copying them. For example, an access path can be copied and, at the same time, shared by a programmer editing a function based on that access path. It would not be possible, however, to attempt to edit the access path.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

421

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Use the ERRLVL parameter to specify how many object locks may fail before stopping. This is useful when a small number of objects is involved so that they can be released and the copy process restarted. When a large number of objects is involved it may be easier to stop after the first object lock fails (ERRLVL(*NONE)), so that processing can be deferred until the whole model becomes available.

*MODELThe source model is exclusively locked for the duration of processing. No concurrent access is allowed in this state.

ERRLVL
Specifies how many object lock errors can occur before processing stops. This applies only where you lock individual objects in the source model, namely when MDLLCK is *BYOBJECT. Note that processing will stop even if only one object cannot be locked. This parameter simply allows processing to continue so that a given number of errors may be accumulated before stopping. Values for this parameter are described in the following:

*NONE(default) Processing will stop when the first object that cannot be locked is encountered. *NOMAXProcessing will stop at the end of the expansion phase if any objects could not be locked. error levelProcessing will stop when the number of objects which cannot be locked equals or exceeds the entered value.

Notes

You cannot copy to a target model if it is in use by another job. However, you can run the YCPYMDLOBJ command with the CPYOPT(*PREPASS) option. For concurrent use of the source model, refer to the MDLLCK parameter. The model library named in the TOMDLLIB parameter (target model) must be the first model library in your library list. For SQL you must create an SQL collection before generating source. When YCPYMDLOBJ copies the selected entries to the target, it matches objects between the two models by name and type. By default, an object in the source model is copied to the target model using the same object name. You can override this default by specifying a different name for an object in the target model on the YEDTCPYLST rename panel or by changing the object's Copy name before adding the object to the model list for copy. For existing entries you can refresh the copy name from the object's details using option or for all entries on a list using the Check Model List command (YCHKMDLLST).

422

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

When you create a model object, by default its Copy name will be the same as its object name. However, if the default Copy name is not unique within the model for the owner and object type, the Copy name is set to the object name suffixed by the objects 7-digit object surrogate. For object types other than conditions and physical access paths, if you rename an object, its Copy name is not changed; if you rename a condition or physical access path, the Copy name is automatically set to the new object name. You can manually reset an objects Copy name using the Change Model Object Description (YCHGMDLOD) command. The Copy Model Objects command does the following: Expands the model listEach of the explicitly selected objects in the list are examined in turn to see if it has any associated objects which are required in order for it to be used. Any referenced objects which are found are added to the model list as implicit selections. This means that they will be copied only if they do not already exist in the target model. Possible referenced objects for the file object type are as follows: Any other files referenced by the relations which define the file. The following messages belonging to the file:
file not found file already exists

The fields arising from the resolution of the relations or entries.

Possible referenced objects for the field object type are as follows: If the field is a REF field, the based-on field. Any field conditions, associated constants, and external message IDs.

Possible referenced objects for the access path object type are as follows: The based-on file. Any associated access paths and referenced access paths.

Possible referenced objects for the functions object type are as follows: The based-on access path. Any function parameters, any files used to define function parameters. Any objects referenced by the function's action diagram: constants, fields and conditions. Function fields. Action bars.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

423

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Note: Functions called by a selected function (other than built-in functions and message functions) are not copied unless they too are selected or unless CPYSUBFUN is specified to be *DBF, *INT or *ALL as appropriate. See also the Note later in this section on CPYSUBFUN and EXPRQDOBJ for details. The possible referenced object for the messages object type is as follows: Any parameters (and files and fields named in parameter definition). There are no referenced objects for the Application areas object type. Note: The expand list does not automatically include functions of type SELRCD which are implicitly, rather than explicitly, referenced by other functions. If there are fields with a user-defined data type of the same name in both models, fields from the source model will take the attributes of the data type in the target model, unless the internal/external conversion functions do not match; that is, the target model data type attributes will not be overwritten.

Preliminary CheckMakes a preliminary (pre-pass) check against the model named in the TOMDLLIB parameter. This checks whether an object with the same CA 2E name is already present in the target model and if so, whether it is the same in all its attributes. If there is a discrepancy, one of two types of messages will be generated on a report:

WarningsA warning message indicates an insignificant difference between the two models, (i.e., one that can be handled automatically by the subsequent copy process). Warning messages can be subdivided into two classes by their severity levels: Severity 10(Additional objects) These occur when there are fewer associated objects in the target model than in the source model. In this case, the additional objects can be copied to the target model without changing any existing values in the target model. Severity 20(Property differences) These occur when the objects differ in one or more of their properties (for example, fields have different lengths or data types) but it will be possible to produce a viable new version simply by replacing the existing version in the target model with the version from the source model. ErrorsAn error message will be issued if the two versions of an object differ in a way that cannot be handled automatically. For instance:

The object in the target model has been locked to prevent change. The condition values for a given field conflict. A required relation does not exist in the target model.

424

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

You may find further information about particular messages by using the i OS Display Message Description (DSPMSGD) command to display the second level text for the message. All YCPYMDLOBJ messages begin with the prefix Y2V5 and reside in the Y2MSG message file. If any error messages are generated during the pre-pass, no objects can be copied. You must first take action to remove the errors, then rerun the copy. Actions that you may take include:

Changing, adding or removing objects in either of the two models as appropriate. Using the command Edit Copy List (YEDTCPYLST) to specify alternative names under which to copy the new objects into the target model.

If CPYOPT(*PREPASS) is specified, the YCPYMDLOBJ utility will stop at this point. If CPYOPT(*COPY) is specified, and no errors are detected (i.e. warnings only), the YCPYMDLOBJ utility will copy the objects indicated by the model list into the target model. An audit report is generated which lists all the objects copied. In order to produce a viable copy of an object, one or more referenced objects may also need to be present in the target model; the referenced object may in turn require further objects. You should be aware of the implications that the inter-dependencies between the objects in a model have for the copying process, and in particular make sure you understand when an associated object will or will not be copied. The rules for copying an object are:

Any object that you explicitly select will always be copied. If a version of the object already exists in the target model, it is replaced. Otherwise, it is added. Objects that are not explicitly selected, but are implicitly required by an object that has been selected, will be added to the target model only if they are not already present in it. Otherwise the existing versions of the referenced objects will be used.

In summary, an object will never be replaced by the YCPYMDLOBJ command unless you explicitly select it. Effect on Target Model Selection in Model list Explicit Implicit ` REPLACE DO NOT COPY Not already present ADD ADD

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

425

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

The following table shows for each object type the possible referenced object types that may be copied or replaced.: Object Selected FIELD Associated objects copied by YCPYMDLOBJ (Unless object already exists in the target model)

Any conditions based on the field Any referenced field if it does reference another field External message identifiers Relationships that define the file Fields referenced by the relationships Other files referenced by the relationships Not found and already exists messages associated with the file File on which the access path is based Any other access paths the access path references Access path on which the function is based Any messages the function uses Any function fields the function uses Any fields used as parameter Any access paths used to define the parameters Fields used as message parameters Any access paths used to define message parameters Any files upon which the access paths are based

FILE

ACCESS PATH

FUNCTION

MESSAGE

APPLICATION AREA

Nothing extra (i.e. files present in the source model that are absent in the target model will not be copied).

Note that:

When a field is replaced, any existing conditions it may have in the target model are retained. In other words, the copy is a merge. New conditions are added but existing conditions are not updated. If there is a conflict over the condition values that would prevent the merge, an error message will be sent. When an application area is replaced, any existing files assigned to it in the target model are retained.

426

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Example
The following example shows this principle diagrammatically. Assume that you have a target model that already contains two objects (for example, files) B and C. Assume that you wish to copy a list of objects from a source model including an object A (for example, an access path) which depends on four other objects B, C, D, and E. In your model list you select A, and also C and E. Then the YCPYMDLOBJ command proceeds as follows when copying object A:

Object B is implicitly selected but already present in the target model, so it is not copied. For example, the new version of A refers to the existing version B' in the target model. Object C is explicitly selected, so it is replaced with the new version from the source model. Object D is implicitly selected and not present, so it is added to the target model. Object E is explicitly selected, so it is added to the target model. Object A is added to the target model.

Contents of Models Before and After Copy

Model 1 SOURCE

Model 2 TARGET BEFORE

B'

Copy List *SELECTED

* * * A B rqd C rqd A

Model 2 TARGET BEFORE

A B C D E

C'

B C D

* *

D rqd E rqd

The following considerations apply to the issuing of generated field names and source member names if CPYVNM(*YES) is specified: If either the name for a field or RPG prefix for a file or source member name from the source model have already been used in the target model, a warning will be generated. If the target model is allocating names automatically (i.e., a value of *YES specified for the YALCVNM model value), a newly generated name or RPG III prefix will be allocated to the object when the copy occurs. If you are not autoallocating names, they will be left blank for you to supply. The new names will be recorded on the audit listing.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

427

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Note: If different model prefixes are used for the two models (specified with the YOBJPFX model value), these will be retained in source member names after copying. In this instance it is very unlikely that there will be any conflict of source member names.

The following considerations apply to the issuing of message identifiers. If a message identifier already exists in the target model, and you have specified that the target model is to allocate message identifiers automatically (i.e., the YMSGPFX model value is not *NO), a new identifier will be assigned. If you have not, the identifier will be left blank. If the messages in the source and target models are stored in message files of different names (the message file is determined by the message prefix), then a new message file with the same name as that used in the source model will be created in the target model. This fact is recorded on the audit listing.

The following considerations discuss how the Copy Subfunctions (CPYSUBFUN) and Expand Required Objects (EXPRQDOBJ) parameters affect the copying of functions. The EXPRQDOBJ parameter applies only when a function is not included by CPYSUBFUN (does not qualify for expansion) and does not exist in the target model. A function qualifies for expansion of references if it is explicitly selected, it meets the criteria set by the CPYSUBFUN parameter, or if it does not exist in the target model and EXPRQDOBJ is set to *YES. The following table shows how the CPYSUBFUN and EXPRQDOBJ parameters work together to control whether references are expanded for a function and whether the function is copied to the target model. Note that this table applies only if the function is NOT explicitly selected and the CPYSUBFUN parameter is not set to *ALL.

428

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Relationship of CPYSUBFUN and EXPRQDOBJ Parameters

Expand Required Objects (EXPRQDOBJ = Y) Function exists in target model CPYSUBFUN qualifies function for expansion of references CPYSUBFUN does NOT qualify function for expansion of references Notes: 1. The function is not copied since it already exists in the target model; however, implicitly required objects that do not exist in the target model are copied. Use these settings in *PREPASS mode to identify new objects that have not been explicitly selected and may need to be copied. The function is copied because it does not exist in the target model. Implicitly required objects that do not exist in the target model are always copied. These settings improve performance since functions that exist in the target model are not expanded. Since EXPRQDOBJ caused references for the function to be expanded, it effectively overrides the CPYSUBFUN setting. These settings improve performance since functions are expanded and copied only when they do not exist in the target model. Implicitly required objects that do not exist in the target model are always copied. You should run this in *PREPASS mode and examine the report to ensure that unexpected objects are not copied to the target model. Processing stops since the function's required objects cannot be identified in the target model. A message identifies the function so you can take corrective action; for example, you can explicitly select the function for copy. Do NOT Expand Required Objects (EXPRQDOBJ = N) Function does NOT Function exists in target model exist in target model Function does NOT exist in target model

Function expanded Function expanded Function expanded Function expanded but not copied. (1) and copied. (2) but not copied. (1) and copied. (2)

Function neither expanded nor copied. Processing continues normally. (3)

Function expanded Function neither and copied. (4) expanded nor copied. Processing continues normally. (3)

Function neither expanded nor copied. Processing stops. (5)

2. 3. 4.

5.

Example
To copy objects in a model list in THISMDL to a model THATMDL:
YCPYMDLOBJ FROMMDLLIB(THISMDL) + TOMDLLIB(THATMDL) CPYOPT(*COPY) + CPYSUBFUN(*ALL)

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

429

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

YCRTGENOBJ (Create Generation Objects) Command

Duplicates the generation and runtime objects, which are required to run CA 2E generated applications, into a specified target library. This command is useful when you want to execute an application independently of CA 2E. It also allows you to create, as an option, source physical files and to duplicate CA 2E application objects via the YDUPAPPOBJ command.

Optional
*CURLIB YCRTGENOBJ OBJLIB library name *YES CVTCNDVAL *NO *YES CRTAPPOBJ *NO
*CHANGE AUT *ALL *EXCLUDE
*YES CRTPMTMSG *NO
CA 2E Modules: *ALL Job: B,I Pgm: B,I

*YES CRTSRCPF *NO *YES CVTMDLMSG *NO *ALL CRTOPT *NEW

*LNG IGCDTA *YES *NO

Parameters
The following are parameters for the YCRTGENOBJ command.

OBJLIB
Name of the target library into which the required generation objects are duplicated. Values for this parameter are described in the following:

Library name(default) The name of the target library. *CURLIBUse current library for invoking job.

CRTSRCPF
Duplicate source physical files into target library. This command duplicates source physical files for help text or application source. Values for this parameter are described in the following:

430

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*YES(default) Duplicate all source physical files. *NOSource physical files are not duplicated.

CVTCNDVAL
Specifies whether the Convert Condition Values command (YCVTCNDVAL) is to be run as part of processing. Values for this parameter are described in the following:

*YES(default) Run the command. *NODo not run the command.

CVTMDLMSG
Specifies whether the Convert Model Messages command (YCVTMDLMSG) is to be run as part of processing. Values for this parameter are described in the following:

*YES(default) Run the command. *NODo not run the command.

CRTAPPOBJ
Create CA 2E application objects. If *YES is specified, the YDUPAPPOBJ command will be invoked, specifying DUPOPT(*ALL). Values for this parameter are described in the following:

*YES(default) Create CA 2E application objects. *NODo not duplicate CA 2E application objects.

CRTOPT
Duplicate existing objects option. Values for this parameter are described in the following:

*ALL(default) Duplicate all objects. Replace any existing objects with updated versions. *NEWOnly duplicate objects that do not already exist in the destination library.

AUT
Authorization rights granted to created libraries and source files. Values for this parameter are described in the following:

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

431

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*CHANGE(default) Grant operational rights and all data rights. *EXCLUDEDo not grant access rights. *ALLGrant all rights.

IGCDTA
Specifies whether CA 2E is to create source files in the generation library that can contain double-byte character set (DBCS) data. Values for this parameter are described in the following:

*LNG(default) The source files created in the generation library may contain DBCS data depending on the LNG parameter value. The i OS national language versions taking IGCDTA (*YES) by default are Japanese (*JPN) and Uppercase set (*UCS). *YESThe created files may contain DBCS data. *NOThe created files may not contain DBCS data.

CRTPMTMSG
Create user prompt message file (NL3). Values for this parameter are described in the following:

*NO(default) Do not create user prompt message file. *YESCreate user prompt message file.

Notes

If *YES is specified on the CRTSRCPF parameter, empty source physical files will be created in the target library. Otherwise, the QTXTSRC file from the first generation library encountered in the library list will be duplicated. The CRTAPPOBJ parameter will use the CRTOPT parameter to determine which application objects will be duplicated. You must have a GENLIB attached to the model. (Data area MDLLIB/YGENLIBRFA cannot contain *NONE).

Example
To create the required generation and application objects into the library APPLIB creating source physical files:
YCRTGENOBJ OBJLIB(APPLIB)

432

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

YCRTJOBLE (Create Job List Entry) Command

This command provides the means by which an object, together with its auxiliary objects, may be placed onto a job list for regeneration and/or compilation. You can optionally generate the object before placing it on the job list. It accesses the first model found in the library list. Objects may be identified by name or by object surrogate key number.

Required
*OBJSGT YCRTJOBLE OBJNAM owner name
*OBJNAM OBJSGT object surrogate number
*MDLPRF *MDLPRF/ *USER JOBLST *MDLLIB/ *JOB model library/ job list name

*ACP object name *FUN

Optional
*GENERATE CRTOPT *COMPILE *PREGEN
CA 2E Modules: *ALL

*NO SBMMDLCRT *YES *EDIT

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCRTJOBLE command.

OBJNAM
The object name of the primary object which is placed on the job list. This parameter consists of three elements which together identify a model object. Values for this parameter are described in the following:

*OBJSGT(default) Single value indicating that the object surrogate key number is used to identify the model object placed on the job list.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

433

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

object owner nameThe character name of the object which owns the object to be placed. Thus, for a function, the owning file would be entered. object nameThe character name of the object to be placed. object typeThe object type of the object. *ACPObject is of type access path. *FUNObject is of type function.

OBJSGT
The object surrogate key number of the model object that is placed on the job list. Values for this parameter are described in the following:

*OBJNAM(default) Use object name to identify the model object. object surrogate numberThe surrogate key number of the model object.

JOBLST
The name of the CA 2E job list that the object is placed on. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the job list name should be taken from the current user's model profile in the model. *USERSpecial value meaning that the user profile name of the current user is used as the job list name. *JOBSpecial value meaning that a job list with the same name as the current job name is used. job list nameThe name of the list to be used.

CRTOPT
This parameter specifies the default action for entries on the target job list. Values for this parameter are described in the following:

*GENERATE(default) The job list entries should be ready for object regeneration and recompilation. *COMPILEThe job list entries should be ready for object recompilation only. *PREGENThis option specifies that the source for the object is generated prior to the entry being placed on the job list for compile. Note that this will involve an interactive generation if the command is executed in an interactive job.

434

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

SBMMDLCRT
This parameter specifies whether the resulting job list is submitted for model generation/creation. Values for this parameter are described in the following:

*NO(default) The job list is not submitted. *YESThe job list is submitted after being updated. *EDITThe job list is edited prior to submission.

Notes

If the object and its auxiliaries already exist on the target job list, the status is set to that which is defined on the command. However, note that in certain cases the command will not be able to convert. For example, if the object is currently being generated, then it would not be appropriate to adjust its status. If unable to convert an existing job list entry, an exception message is sent. Model objects can either be identified by object name (OBJNAM) or by object surrogate key number (OBJSGT). If the OBJNAM parameter is used, the processing program must convert to surrogate key number internally. Thus, it will normally be more efficient to use the surrogate number if this value is available. The surrogate number for an object can be obtained using the Retrieve Model Object command (YRTVMDLOBJ).

Example
To place the function Process Orders onto the job list of the current user for regeneration and recompilation enter the following command:
YCRTJOBLE OBJNAM( 'Order' 'Process Orders' + *FUN ) JOBLST( *USER ) CRTOPT ( *GENERATE )

YCRTMDLLIB (Create Model Library) Command

Creates the objects necessary to use CA 2E: (1) library to hold the design model, (2) library in which to place the generated source and compiled objects, and (3) library to hold the SQL collection.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

435

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Optional

436

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Y2MDL YCRTMDLLIB MDLLIB *NONE library name

*DBFGEN *GEN SQLLIB *NONE library name SYSTXT text

*GEN P GENLIB *NONE library name

*SYS *CUATEXT DSNSTD *CUAENTRY *s38 OBJPFX prefix UU

Y2 VLSPFX *OBJPFX prefix MSGPFX

USR *NONE prefix

*NPT

*NONE CHGCTL library name WSNGEN

*GUI *JVA *VB

*SYS *MSGID PMTGEN *LITERAL *OFF MSGVNM message file name *MSGPFX

*SYS DBFGEN *DDS *SQL

*HLLGEN *RPG HLLVNM *CBL *RPGCBL *VNM

*SYSHLL HLLGEN *RPG *CBL

*SYSNPH *YES NPTHLP *TM *UIM

*LIBL LNG One of the following: *DAN, *DTC, *ELL, *ENG, *ESP, *FIN, *FRN, *HRZ, *ISL, *ITL, *IVT, *JPN, *NDL, *NSK, *PTG, *SLO, *SVK, *UCK IGCDTA *LNG *YES *NO

GENHLP *NO

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

437

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*LIBL/ *MDLLIB *CURLIB LIBLST library name/ *NONE library list name

*MDLLIB 25 maximum LIBL library name

*JOBD *LIBL/ JOBQ *CURLIB/ library name/
*CHANGE AUT *EXCLUDE *ALL
CA 2E Modules: *ALL Job: B,I Pgm: B,I

QBATCH JOBD job description name

job queue name

Parameters
The following are parameters for the YCRTMDLLIB command.

MDLLIB
Name of library to contain the design model and application design. Sets the YMDLLIB model value. This name should have the MDL suffix. The value for this parameter is as follows:

*NONEDo not create a model library.

GENLIB
Name of library into which source is generated and into which programs and files are compiled. Sets the YGENLIB model value. Values for this parameter are described in the following:

*GEN(default) Derive name of generated source library according to the rules given in the notes section. *NONEDo not create a source library.

438

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

SQLLIB
Name of library into which SQL collection for database implementation is placed. Sets the YSQLLIB model value. Values for this parameter are described in the following:

*DBFGEN(default) If *SQL is specified for the DBFGEN parameter, create a library for an SQL collection and generate a name according to the rules given in the notes section. *NONEDo not create a collection library. *GENDerive the name of the SQL collection library.

SYSTEXT
Text for the model. Sets the YMDLTXT and YCMPTXT model values.

DSNSTD
Default design standards. Sets the default values for the model values and other parameters controlling aspects of the user interface design standards. Values for this parameter are described in the following:

*SYS(default) Set default according to YSYSSAA model value. *CUAENTRYSet default to SAA CUA Entry model standard. *CUATEXTSet default to SAA CUA Text model standard. *S38Set defaults to System/38 default standard.

OBJPFX
Application object prefix added to the beginning of all member names that contain source generated by CA 2E. The prefix is only used if automatic generation of member names is specified (system value YALCVNMRFA=Y). For example, UU+ CUDAP=UUCUDAP, UU+CHCUR=UUCHCUR. Sets the YOBJPFX model value. The value for this parameter is as follows:

UU(default) Application prefix.

VLSPFX
Values list object prefix added to the beginning of the names of all objects used to implement the values list facility (xxVLLSP, xxVLLSL0, xxVLLSR, xxVLLLSR#). For example, UU+VLLSP=UUVLLSP. Sets the YVLSPFX model value. Values for this parameter are described in the following:

Y2(default) Application prefix.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

439

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*OBJPFXUse the same value as that specified for the OBJPFX parameter.

MSGPFX
Message identifier prefix used on all i OS message descriptions generated by CA 2E. For example, USR + 0015 = USR0015. Sets the YMSGPFX model value. Values for this parameter are described in the following:

USR(default) Message prefix. *NONEAllocate message identifiers manually.

WSNGEN
Specifies whether functions are implemented for NPT terminals or for Windows communicating with an IBM i host. This parameter sets the YWSNGEN model value. Values for this parameter are described in the following:

*NPT(default) Generate an NPT implementation. *GUIGenerate a Windows implementation. *JVAGenerate a Windows implementation for use with a Web browser. *VBGenerate a Windows implementation for use with Visual Basic Forms.

PMTGEN
Device prompt generation option. Sets the YPMTGEN model value. Values for this parameter are described in the following:

*LITERAL(default) Generate device prompts in display and printer files DDS as fixed literals. *MSGIDGenerate device prompts in display file DDS source as MSGID references and message descriptions. *SYSDefault to value specified by YSYSPMT system model value. *OFFA message ID is allocated but is not generated in the message file.

DBFGEN
Default method for implementing CA 2E access paths as database objects. Sets the YDBFGEN model value. Values for this parameter are described in the following:

*SYS(default) Default to value specified by YSYSDBF system model value.

440

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*DDSImplement using DDS and HLL access. *SQLImplement using SQL/400 DDL and DML.

HLLGEN
Default HLL language in which to generate program source. Sets the YHLLGEN model value. Values for this parameter are described in the following:

*SYSHLL(default) Default to value specified by YSYSHLL model value. *RPGGenerate programs in RPG III by default. *CBLGenerate in COBOL by default.

HLLVNM
HLL language naming conventions for DDS names generated by CA 2E. Sets the YHLLVNM model value. Values for this parameter are described in the following:

*RPGCBL(default) Naming to be compatible with RPG and COBOL requirements. *RPGNaming to be compatible with RPG requirements. *CBLNaming to be compatible with COBOL requirements. *HLLGENDefault to the same value as specified by the HLLGEN parameter. *VNMApply only name restrictions.

CHGCTL
This parameter allows the new model to run with change control. The library name specified should contain change management exit programs. Values for this parameter are described in the following:

*NONE(default) Change control is not enabled for the model. library nameThe library containing change control exit programs.

For more information on change control, see the Start Change Control (YSTRCHGCTL) command section in this guide.

MSGVNM
Name of message file used to store message descriptions generated by CA 2E. Sets the YMSGVNM model value. The value for this parameter is as follows:

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

441

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*MSGPFX(default) Name is based on the value specified for MSGPFX parameter. If MSGPFX(*NONE) or MSGPFX(*USR) is specified, QUSRMSG is used as the message file name. Otherwise, the message file name is created by concatenating the object prefix (OBJPFX) and the message prefix with the letters MSG, for example, AB +ORD +MSG = ABORDMSG.

GENHLP
Generate help text. Values for this parameter are described in the following:

*YES(default) Generate help text when generating functions. *NODo not generate help text by default.

NPTHLP
Default NPT help generation language. Values for this parameter are described in the following:

*SYSNPH(default) Use system-wide model value YSYSNPH. *TMGenerate help text in TM/38. *UIMGenerate help text in UIM.

LNG
National language for system data in model. You must have the appropriate national language product libraries loaded onto your machine and referenced in a data area in the base product library. The value for this parameter is as follows:

*LIBL(default) Use the language of the first product library found in the library list. Must be one of the national language options. Note: When specifying a national language it is advisable to make sure the library list of the job running the YCRTMDLLIB command is correct. It should include the following libraries in order:

CA 2E Toolkit national language library CA 2E Toolkit English product library CA 2E national language library CA 2E English product library

If a model that requires national language support is created without this prerequisite, edit the model library list, using the Edit Library List command (YEDTLIBLST), to correct the error.

442

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

IGCDTA
Specifies whether CA 2E is to create source files in the generation library that can contain double-byte character set (DBCS) data. Values for this parameter are described in the following:

*LNG(default) The source files created in the generation library may contain DBCS data depending on the LNG parameter value. The i OS national language versions taking IGCDTA (*YES) by default are Japanese (*JPN) and Uppercase set (*UCS). *YESThe created files may contain DBCS data. *NOThe created files may not contain DBCS data.

LIBLST
Qualified name of a library list that is to be built or updated: the library list will contain the libraries necessary to use the model that is being created. Values for this parameter are described in the following:

*MDLLIB(default) Library list has same name as the model library. *NONEDo not create a library list.

LIBL
Libraries that are to be included in library list specified by the LIBLST parameter, and in the initial library list of the job description specified by the JOBD parameter. Up to 25 libraries may be specified. The value for this parameter is as follows:

*MDLLIB(default) Creates the following library list: 1. 2. 3. 4. 5. 6. 7. 8. QTEMP GENLIB parameter value SQLLIB parameter value MDLLIB parameter value QGPL National language library depending on LNG CA Toolkit product library CA 2E product library, depending on HLLGEN and WSNGEN

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

443

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

JOBD
Name of job description that is to be used to compile application objects. This will reside in the library nominated by the MDLLIB parameter. Sets the YCRTJBD model value. The value for this parameter is as follows:

QBATCH(default) Job description name.

JOBQ
Qualified name of job queue where batch requests are submitted. The value for this parameter is as follows:

*JOBD(default) Use default job queue name as specified on job description QBATCH in the null model library.

AUT
Authorization rights granted to created libraries and source files. Values for this parameter are described in the following:

*CHANGE(default) Grant operational rights and all data rights. *EXCLUDEDo not grant access rights. *ALLGrant all rights.

Notes

When you run this command you must have all of the appropriate product libraries in your library list. To use the command, you must be authorized to the following i OS commands: Create Library (CRTLIB) Create Physical File (CRTPF) Create Data Area (CRTDTAARA) Create Source File (CRTSRCPF) Create Job Description (CRTJOBD) Create Duplicate Object (CRTDUPOBJ) Create Journal (CRTJRN) Create Journal Receiver (CRTJRNRCV) Create Data Dictionary (CRTDTADCT)

This command creates the following objects:

444

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

MDLLIB (Model library): Creates all files necessary for a CA 2E model. Creates a message file (OBJPFX + USRMSG). Sets model values as indicated on specific parameters. Changes INLLIBL of job description specified by JOBD parameter to LIBL value, unless LIBLST(*NONE) is specified.

GENLIB (Generation library):

A journal (OBJPFX + JRN), and journal receiver (OBJPFX + 00001). A menu file YDSNMNU. An action bar file (OBJPFX + ABDAP). YDSPHLP command help display data areas (YMHPFLA, HMHPLBA).

You can change the model values that you specified by using the command Change Model Value (YCHGMDLVAL). If you specify a value of *MDLLIB for the LIBLST parameter, then the appropriate national language product library is included in the library list automatically. If you specify the library list explicitly, then you should ensure that the appropriate national language library is in the library list before either of the CA 2E Toolkit or CA 2E product libraries. The DSNSTD parameter controls the initial values for all the parameters affecting design standards, CUA or non-CUA. DSNSTD sets: Which standard header functions are to be the default. The default command keys set to use. The initial value for the YSAAFMT model value; this value in turn controls design standard for detailed aspects of panel layout, such as how command and subfile explanation instruction text is built. The YLHSFLL model value, which controls the appearance of field text leaders on screen designs. The YCUAPMT model value, which controls whether the CUA prompt command key to display a list of allowed values, is enabled. The YCUAEXT model value provides additional CUA device design compliance if the value is *C89EXT. The default field attributes which specify the default field highlighting and color attributes for different field usages.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

445

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Design Features Controlled by the DSNSTD Parameter

Design feature Default DFNSCRFMT function Default DFNSCRFMT secondary Default command keys YSAAFMT model value YLHSFLL model value YCUAPMT model value (F4) YHLPCSR model value *CUATEXT CUA Text *CUAENTRY CUA Entry *S38 *STD header

CUA Window

CUA set *CUATEXT *SAA *YES *YES

CUA set *CUAENTRY *SAA *NO *YES CUA values

S/38 set S/38 :.:..:..: *NO *NO S/38

YEDTFLDATR field CUA values attributes

The YSAAFMT model value is initially set by the DSNSTD parameter on YCRTMDU. It controls the following aspects of automatic panel design:

Design Aspects Controlled by the YSAAFMT Model Value

Design Aspects *CUATEXT *CUAENTRY *S38 Handling of Field Trailers CUA CUA YLHSFLL

Initial Panel Layout CUA Text CUA Entry S/38

Instruction Set Form Fn= n= Fn= n= CMD: SEL:

Condition Value List Pop-Window Panel Panel

Some of the parameters (GENLIB, SQLLIB, GENFLR) support a special value to provide automatic creation of a suffixed instance name. For example, if you specify MYMDL for the MDLLIB parameter and you specify *GEN, the default value, for the GENLIB, SQLLIB, and GENFLR parameters, the instance names will be MYGEN, MYSQL, and MYFLR, respectively.

446

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

The common root used in all the instance names is derived from the MDLLIB parameter value. The rules for deriving the root and appending the respective suffixes are as follows: Look for the letters MDL in the MDLLIB value. If found, substitute the suffix letters to create the instance name. For example, if MDLLIB is Y2MDL, then the name used for GENLIB would be Y2GEN. The name used for GENFLR would be Y2FLR. If the letters MDL are not found in the MDLLIB value, simply append the suffix letters. For example, if MDLLIB is MY, then the name used for GENLIB would be MYGEN. If the model library name is more than seven characters long, the suffix will be truncated. If the model library name is 10 characters long, an escape message will be sent.

Example
To create a set of model libraries for an RPG and CBL application using CUATXT design standards:
YCRTMDLLIB SYSTEXT(My system) + MDLLIB(MYMDL) GENLIB(MYGEN) OBJPFX(MY) +

HLLVNM(*RPGCBL) DSNSTD(*CUATEXT)

This creates the following:

Library MYMDLLibrary to contain model. Library MYGENLibrary to contain generated source. Library list MYMDLLibrary list for My system model, which contains the following libraries: QTEMP MYMDL MYGEN QGPL CA 2E product library CA 2E Toolkit library

YCRTMDLVSN (Create Model Version) Command

This command lets you copy a model object to create a new version of that object. You can identify the originating object by name or by object surrogate key number. At present, you can create versions of functions or messages only.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

447

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Required
YCHGMDLPRF MDLPRF model user profile name

Optional
*SAME SSNLST *MDLPRF list name LOGCHG *SAME *YES *NO

*SAME COMPCHG *YES *NO VIEWONLY

*SAME *YES *NO

*SAME USROPT *LIBL library name/ QAUOOPT file name

*SAME *FILE USOPTMBR *FIRST *MDLPRF member name *SAME MDLLST *MDLPRF list name
*SAME NPDFUN *NONE Notepad function
CA 2E Modules: *ALL

*SAME ADERNMODE *YES *NO

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCRTMDLVSN command.

FRMOBJNAM
The name of the object that is copied. Values for this parameter are described in the following:

*FRMOBJSGT(default) Single value indicating that the object surrogate number parameter is used to identify the model object. object owner nameThe character name of the object which owns the object. Thus, for a function, the owning file would be entered.

448

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*MESSAGESThe internal file *Messages is the owner of the object (note that this value is only allowed for objects of type *MSG). object nameThe character name of the object. object typeThe object type of the object. *FUNObject is of type function. *MSGObject is of type message. Note that for objects of type *MSG, the owner is the *Messages file.

FRMOBJSGT
Unique number identifier of the model object that is copied. Values for this parameter are described in the following:

*FRMOBJNAM(default) Use the object name parameter details to identify this model object. object surrogateThe surrogate number of the model object.

TOOBJNAM
The name of the object to which usage dependencies in the model are redirected. Values for this parameter are described in the following:

*GENERATE(default) This special value indicates that a new name is generated for the new version. To control how the name generates, you should use the shipped exit program YOBJNAMRIC. object nameThe new object name.

CUROBJ
This parameter allows the developer to choose whether to make the new version current. Values for this parameter are described in the following:

*NO(default) The new version is not made current. *YESThe new version is made current.

TFRNAM
This special value indicates whether a transfer of names is to occur as part of processing. Values for this parameter are described in the following:

*NO(default) No transfer of names is made. *YESIf the new version is made current following its creation, then the name of the current version is transferred to the new version. Otherwise, the name of the from version is transferred.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

449

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

CHGTYP
This parameter allows the user to control whether the making of the new version current is treated as a significant change. If a value other than *NONE is specified, then component change processing will be invoked to reflect the change throughout users of the new object. This parameter may only be specified if CUROBJ is set to *YES. Values for this parameter are described in the following:

*NONE(default) The action of making the new version current is not treated as a significant change in the model; no component change processing is to occur. *PRIVATEComponent change processing is to occur to apply a private change to the users of the new version. *PUBLICComponent change processing is to occur to apply a public change to the users of the new version. *FRMOBJThe change type associated with the From object will be examined by component change processing.

RTNEDTSGT
CL variable that receives the surrogate of the resulting edit object. Decimal variable, seven digits packed.

RTNNEWSGT
CL variable that receives the surrogate of the new version. Decimal variable, seven digits packed.

RTNCURSGT
CL variable that receives the surrogate of the current version in the group. Decimal variable, seven digits packed.

Notes

A search is made for the from model object in the first model library found in the library list. If the 25-character object name is transferred from the source object to the target object, the source object must be renamed in the process. The shipped 25-character exit program, YOBJNAMRIC, will be used for this purpose.

450

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Example
To create a new version of the Edit Widget function and call it Edit Sprocket enter the following command:
YCRTMDLVSN FRMOBJNAM( 'Widget' 'Edit + Widget' *FUN ) TOOBJNAM( *FRMOBJNAM + 'Edit Sprocket' *FRMOBJNAM )

YCRTOBJVSN (Create Object Version) Command

This command provides the means by which an object can be copied to create a new version of that object. The originating object can be identified by object surrogate number. At present, you can create versions of functions or messages only. Note: The processing of this command involves the prompting of the Create Model Version command.

Required
YCRTOBJVSN FRMOBJSGT object surrogate

Optional
*YES ALWADJCUR *NO
CA 2E Modules: *ALL Job: B,I Pgm:

Parameters
The following are parameters for the YCRTOBJVSN command.

FRMOBJSGT
Unique number identifier of the model object that will be copied. The value for this parameter is as follows:

object surrogateThe surrogate number of the model object.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

451

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

ALWADJCUR
This parameter indicates whether the user is allowed to adjust the currency status of versions in the group to which the new version will belong. In practical terms, it determines whether the CUROBJ and TFRNAM parameters on the Create Model Version command (YCRTMDLVSN) are prompted. Values for this parameter are described in the following:

*YES(default) The user will be allowed to access to the CUROBJ and TFRNAM parameters on the prompted Create Model Version command. *NOThe user will not be allowed access to the CUROBJ and TFRNAM parameters on the prompted Create Model Version command.

Example
To create a new version of the object identified by object surrogate number identifier 1103454:
YCRTOBJVSN FRMOBJSGT( 1103454 )

This will result in the Create Model Version panel being prompted where the new name for the object may be entered. <paratext> <pagenum>

YCRTSQLLIB (Create SQL Library) Command

Creates a library containing an SQL/400 collection into which CA 2E generates SQL/400 tables, views, and indexes.

Required
YCRTSQLLIB SQLLIB library name

452

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Optional
*MDLLIB MDLLIB *NONE library name SYSTEXT *MDLLIB *NONE library name

*LIBL/ *MDLLIB *CURLIB/ library list name LIBLST library name/ *NONE
*CHANGE AUT *EXCLUDE *ALL
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCRTSQLLIB command.

SQLLIB
Name of library into which SQL/400 collection is placed. Sets the YSQLLIB model value.

MDLLIB
Name of the model library in which to set the YSQLLIB model value. Values for this parameter are described in the following:

*MDLLIB(default) Default to the first model library name found in the library list. *NONEDo not set model value.

SYSTEXT
Text for the SQL library. Values for this parameter are described in the following:

*SYSTEXT(default) Use text found in model value YMDLTXT in library specified by *MDLLIB. *NONEDo not use text for SQL library.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

453

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

LIBLST
Qualified name of a library list that is built or updated. The library list will contain the libraries necessary to use the model that is being created. Values for this parameter are described in the following:

*MDLLIB(default) Library list has same name as the model library. *NONEDo not create a library list.

AUT
Authorization rights granted to created libraries and source files. Values for this parameter are described in the following:

*CHANGE(default) Grant operational rights and all data rights. *EXCLUDEDo not grant access rights. *ALLGrant all rights.

Notes
To use the command, you must be authorized to the following i OS commands:

Create journal (CRTJRN) Create journal receiver (CRTJRNRCV) Create data dictionary (CRTDTADCT)

Example
To create a library containing an SQL/400 collection for use by CA 2E to associate with a model:
YCRTSQLLIB Library') SQLLIB(TESTSQL) + MDLLIB(TESTMDL) + SYSTEXT('My test SQL/400

YCVTCNDVAL (Convert Condition Values) Command

Converts the condition value lists held in a model into a database file: the database file is used by the display values program to provide an inquiry function from user programs.

454

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

This command must be run in order for new or changed values to be available in the GENLIB for display by an application program. The file must not be in use when you run this command.

Optional
*MDLLIB YCVTCNDVAL *CURLIB library name
CA 2E Modules: *ALL

*GENLIB GENLIB *CURLIB library name

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCVTCNDVAL command.

GENLIB
Name of library into which converted values are placed. Values for this parameter are described in the following:

*GENLIB(default) Use the source generation library named by the YGENLIB model value in the model library. *CURLIBUse current library for invoking job.

MDLLIB
Name of library containing the name of a design model from which the condition values are converted. Values for this parameter are described in the following:

*MDLLIB(default) Use the first model library found in the library list. *CURLIBUse current library for invoking job.

CVTOPT
Determines which condition values should be converted. Values for this parameter are described in the following:

*ALLConvert all condition values. *MDLLSTConvert only those condition values where the LST condition is explicitly selected in the model list specified in the Model object list prompt (MDLLST parameter).

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

455

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

MDLLST
Note: This parameter is ignored unless CVTOPT(*MDLLST) is specified. The qualified name of the model object list that is used. If a LST condition has been explicitly selected in the model list, then the LST condition and all the VAL conditions will be converted. Any other object types in the list (including any VAL conditions where the LST condition has not been explicitly selected) are ignored. The possible model object list name values are:

*MDLPRFSpecial value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the model object list name. model-object-list-namethe name of the model object list to be used. Possible library values are:

*MDLLIBSpecial value meaning that the first model library in the current library list is used as the library for the model object list. library-nameThe name of the model library which contains the model object list.

Notes

The file must not be in use when you run this command. The converted values are placed in a file whose name is constructed from the Value List Prefix model value (YVLSPFX) and the letters VLLSP; for example, XX + VLLSP = XXVLLSP. If a version of the file does not already exist in the library specified by the GENLIB parameter, one will be created. Any existing records in the file are deleted, except for those records flagged as user-added (that is, not generated from a CA 2E model). Useradded records have a value other than blank in the USRMOD field.

The condition values converted by this command are displayed to the user when using generated programs if a ? or F4 is entered into a status field that conditions are defined for. The values are displayed by an HLL program whose name will be constructed from the Value List Prefix model value (YVLSPFX) and the letters VLLSR; for example, XX + VLLSR = XXVLLSR. The program will always be duplicated from the product library when the YCVTCNDVAL command is run. The source for the program is available in the shipped source library. If the value list prefix model value (YVLSPFX) is changed, any programs that call the value list display will need to be regenerated.

456

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Example
To convert the following values from model library MYMDL to generation library MYGEN:
YCVTCNDVAL MDLLIB(MYMDL) GENLIB(MYGEN)

YCVTDSTFIL (Convert Distributed Files) Command

Adds to and/or deletes from the distributed database file the names of files set as being distributed. All files in the model that have been set to Distributed = Y that do not currently exist in the database file will be added. Any file currently in the database that has been changed to Distributed = N will be deleted. This database file is used in conjunction with the configuration table (which contains locations of distributed databases) to define the network of distributed files which can be accessed by distributed application functions. The configuration tables can be edited by the user using the command Work Distributed Files (YWRKDSTFIL).

Optional
*MDLLIB YCVTDSTFIL *CURLIB library name
CA 2E Modules: *ALL

*GENLIB GENLIB *CURLIB library name

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCVTDSTFIL command.

MDLLIB
Name of library containing the name of a design model from which the distributed file entries are selected. Values for this parameter are described in the following:

*MDLLIB(default) Use the first model library found in the library list. *CURLIBUse current library for invoking job.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

457

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

GENLIB
Name of library containing the database file into which distributed file entries are placed. Values for this parameter are described in the following:

*GENLIB(default) Use the source generation library named by the YGENLIB model value in the model library. *CURLIBUse current library for invoking job.

Notes

Distributed files are those files which have been flagged with Distributed = Y on the Edit File Details panel in the model. Entries for all access paths for distributed files are placed in a file Y2DSTFP. If Y2DSTFP does not already exist in the library specified by the GENLIB parameter, it will be created. An entry will also be added to the associated configuration file Y2CFGTP for each access path. If Y2CFGTP does not already exist in the library specified by the GENLIB parameter, it will be created. Any existing records in Y2CFGTP will be preserved only if the associated access path still exists in Y2DSTFP. Otherwise they will be deleted. The editor for the configuration file used by YWRKDSTFIL is shipped as an application defined in the model under the files *Configuration Table and *Distributed File. You must generate this application using the design and generator options you choose before you can use YWRKDSTFIL. The distributed file entries converted are displayed to the user when the YWRKDSTFIL command is executed.

For more information on working with distributed files and the configuration table, refer to the YWRKDSTFIL command.

Example
To convert new or changed distributed files from model library MYMDL to generation library MYGEN:
YCVTDSTFIL MDLLIB(MYMDL) GENLIB(MYGEN)

458

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

YCVTJOBLST (Convert a Job List to CA 2E Toolkit Object List) Command

This command allows a user to convert a CA 2E job list to a CA 2E Toolkit object list. The object list may or may not exist. If it exists, it may be added to or replaced by taking the appropriate option on the LSTOPT parameter.

Optional
*MDLPRF/ *MDLLIB/ YCVTJOBLST JOBLST *CURLIB/ model library/
TEMPLST *QTEMP/ *USER *JOBLST/ OBJLST *CURLIB/ *JOBLST library name/ list name *JOB

*MDLFPRF *USER *JOB list name

*REPLACE LSTOPT *ADD

*NO IGNHLD *YES
CA 2E Modules: *ALL

*NO *EDIT *YES

*NO IGNERR *YES
Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCVTJOBLST command.

JOBLST
The qualified name of the CA 2E job list which is converted. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the job list name is to be retrieved from the model profile details of the current user. *USERSpecial value meaning that the user profile name of the current user is used as the job list name. *JOBSpecial value meaning that a job list with the same name as the current job name is used. list nameThe name of the used list.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

459

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*MDLPRF(default) Special value meaning that the job list library name is to be retrieved from the model profile details of the current user. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used. *CURLIBSpecial value meaning that the model library is derived from the job's current library. library nameThe name of the library.

OBJLST
The qualified name of the CA 2E Toolkit Object List that is the target of the conversion. Values for this parameter are described in the following:

TEMPLST(default) Default list name. *USERSpecial value meaning that the user profile name of the current user is used as the object list name for the target of the command. *JOBSpecial value meaning that a job list with the same name as the current job name is used. *JOBLSTThe object list has the same name as the job list. list nameThe name of the object list to be built. QTEMP(default) The QTEMP temporary library of the current job is used. *JOBLSTThe object list resides in the same library as that of the JOBLST parameter. *CURLIBThe object list resides in the current library of the job. library nameThe name of the library to be the target of the command.

LSTOPT
This parameter specifies the action to be taken if the object list already exists. Values for this parameter are described in the following:

*REPLACE(default) The existing object list should be replaced with the output from this command. *ADDThe existing object list should be augmented with the output from this command.

EDIT
This parameter specifies whether the resulting list is edited as part of processing. Values for this parameter are described in the following:

460

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*NO(default) Editing of the list is not performed. *YESEditing of the list is performed.

IGNHLD
This parameter specifies whether or not HELD entries in the job list should be ignored. Values for this parameter are described in the following:

*NO(default) Held entries are not ignored. *YESHeld entries are ignored.

IGNERR
This parameter specifies whether or not ERROR entries in the job list should be ignored. Values for this parameter are described in the following:

*NO(default) Error entries are not ignored. *YESError entries are ignored.

Notes

The library specified for the job list must be a valid model library. The EDIT parameter is ignored if the job running the command is a batch job.

Example
To build object list MOVLST from the current user's job list, to object list MOVLST in QTEMP, ignoring any entries in error on the job list:
YCVTJOBLST JOBLST( *MDLLIB/*USER ) + OBJLST( QTEMP/MOVLST ) LSTOPT( *REPLACE) + IGNERR( *YES )

YCVTMDLLST (Convert Model List to Job List) Command

This command allows a user to convert the generatable entries in a model object list to a job list. The target job list is created if it does not exist. If it exists, it may be added to or replaced by taking the appropriate option on the LSTOPT parameter.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

461

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Optional
*MDLPRF *ALLOBJ *MDDLIB/ YCVTMDLLST FRMMDLLST model library/ *SELECT *SESSION list name
*MDLPRF *USER JOBLST *FRMMDLLST list name CRTOPT *COMPILE *GENERATE

*USER

*REPLACE LSTOPT *ADD

*ANY COMPCHG *GEN *EDT
*NO SBMMDLCRT *YES *EDIT *GENLIB OBJLIB *CURLIB library name
*NO CVTASSIM *YES
CA 2E Modules: *ALL

*ANY FLAGVAL *SELECTED

*OBJLIB SRCLIB *GENLIB *CURLIB

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCVTMDLLST command.

FRMMDLLST
The qualified name of the model object list that is the source list involved in the conversion. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *ALLOBJSpecial value meaning that a model object list is not used, but that all model objects are included in the command.

462

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*USERSpecial value meaning that the user profile name of the current user is used as the model object list name. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. *SESSIONSpecial value meaning that the session list recorded on the current user's model profile is to be used as the model object list name. list nameThe source model object list name may be entered. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library for the source list. library nameThe model library name for the source list.

JOBLST
The name of the job list that is the target list of the conversion. Values for this parameter are described in the following:

*MDLPRF(default) The target list is specified on the current user's model profile. *USERSpecial value meaning that the user profile name of the current user is used as the target job list name. *FRMMDLLSTSpecial value meaning that the name of the from model object list is used as the target job list name. list nameThe target job list name.

CRTOPT
This parameter specifies the default action for entries in the target job list. Values for this parameter are described in the following:

*GENERATE(default) The job list entries are ready for object regeneration and recompilation. *COMPILEThe job list entries are ready for object recompilation only.

LSTOPT
This parameter specifies the action taken if the job list already exists in the target model. Values for this parameter are described in the following:

*REPLACE(default) The existing job list is replaced with the output from this command. *ADDThe existing job list is augmented with the output from this command.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

463

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

FLAGVAL
This parameter allows model objects to be filtered by the entry flag value. Values for this parameter are described in the following:

*ANY(default) No filtering on flag value. *SELECTEDOnly explicitly selected model objects will satisfy the filter.

COMPCHG
This parameter allows model objects to be filtered by the component changed flag (action required). If used, model objects in the list will be filtered according to the current status of the component changed flag on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on component changed flag. *GENModel objects with status *GEN will satisfy the condition. *EDTModel objects with status *EDT will satisfy the condition.

SBMMDLCRT
This parameter specifies whether the resulting job list is submitted for model generation/creation. Values for this parameter are described in the following:

*NO(default) The job list is not submitted. *YESThe job list is submitted after being updated. *EDITThe job list is edited prior to submission.

OBJLIB
This parameter specifies the object library name to be used on the Submit Model Create command (YSBMMDLCRT). Values for this parameter are described in the following:

*GENLIB(default) Special value meaning that the object library is the generation library of the first model found in the current library list. *CURLIBSpecial value meaning that the object library is the current library. library nameThe object library name.

464

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

SRCLIB
This parameter specifies the source library name used on the Submit Model Create command (YSBMMDLCRT). Values for this parameter are described in the following:

*OBJLIB(default) Special value meaning that the source library name is the same as for the OBJLIB parameter. *GENLIBSpecial value meaning that the source library name is the same as for the OBJLIB parameter. *CURLIBSpecial value meaning that the source library name is the same as for the OBJLIB parameter.

CVTASSIM
This parameter specifies whether or not assimilated files are converted to the job list. Values for this parameter are described in the following:

*NO(default) Assimilated files are not converted. *YESAssimilated files are converted.

Notes

The specified library for the model object list must be a valid model library. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. The FRMMDLLST must exist prior to running the command. If the target job list does not already exist, it will be created and the LSTOPT parameter will be ignored. Only generatable objects will be placed onto the job list, all other model object list entries will be ignored. The CVTASSIM parameter provides the developer with some control over whether assimilated physical files are placed in the resulting job list. Thus, for example, where the physical file is part of some third party software, the developer would wish to avoid attempting to generate and compile the physical file, but would wish any logical files in the model object list to be converted in the normal way.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

465

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Example
To convert all model objects with a component changed status (action required) of *GEN (requiring generation and compilation) to job list OUTLIST from the model library WRKMDL:
YCVTMDLLST FRMMDLLST( WRKMDL/*ALLOBJ ) + LSTOPT( *REPLACE ) COMPCHG( *GEN ) JOBLST( OUTLIST ) CRTOPT( *GENERATE ) +

YCVTMDLMSG (Convert Model Messages) Command

Converts the user message functions held in a design model into i OS message descriptions in one or more message files.

Optional
*MDLLIB YCVTMDLMSG MDLLIB *CURLIB library name
CA 2E Modules: *ALL

*GENLIB GENLIB *CURLIB library name

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCVTMDLMSG command.

MDLLIB
Name of library containing a design model from which the user messages are converted. Values for this parameter are described in the following:

*MDLLIB(default) Use the first model library found in the library list. *CURLIBUse current library for invoking job.

GENLIB
Name of library containing a message file into which user messages are placed. The default name of the message file is obtained from the YMSGVNM model value. Values for this parameter are described in the following:

*GENLIB(default) Use the source generation library named by the YGENLIB model value in the model library. *CURLIBUse current library for invoking job.

466

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

CVTOPT
Determines which model messages should be converted. Values for this parameter are described in the following:

*ALLConverts all model messages. *MDLLSTConvert only those model messages explicitly selected in the model list specified in the Model object list prompt (MDLLST parameter).

MDLLST
Note: This parameter is ignored unless CVTOPT(*MDLLST) is specified. The qualified name of the model object list that is used. If a model message has been explicitly selected in the model list, it will be converted. Any other object types in the list (or any model messages in the model list which have not been explicitly selected) are ignored. Values for this parameter are described in the following:

*MDLPRFSpecial value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the model object list name. model-object-list-namethe name of the model object list to be usedPossible library values are:

*MDLLIBSpecial value meaning that the first model library in the current library list is used as the library for the model object list. library-nameThe name of the model library which contains the model object list.

Notes

This command creates i OS message descriptions from CA 2E message function definitions. The name of the message file that the message descriptions are added to is determined for each message function as follows: If there is an override message file name specified for the message function, then the first message file of that name in the invoking job's library list is used. If no override is specified, then the default message file, (as specified by the YMSGVNM model value in the generation library, as specified by the GENLIB model value) is used.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

467

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

The message files you use must already exist in the relevant libraries and the user must have the necessary authority to update them. The conversion process produces an audit report listing for each user message, the message file used and the success or failure of the conversion.

Example
To convert user messages from model library MYMDL to generation library MYGEN:
YCVTMDLMSG MDLLIB(MYMDL) GENLIB(MYGEN)

YCVTMDLPNL (Convert Model Panel Designs) Command

Converts the panel designs of functions into CA 2E Toolkit panel designs so that they may be used for prototyping.

468

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Optional
*USER *ALL YCVTMDLPNL MDLFILE model file name *SELECT

*ALL MDLFUN model function name

*FUNC *ALL APPCDE application area *OPER CVTTEXT *NONE

*MDDLIB/ *LIBL *CURLIB FILE *USRLIBL *ALLUSR *library name screen file name YDSNPNL

*FILE MBR member name

*YES RPLNAV *NO

*YES RPLNAR *NO
CA 2E Modules: *ALL

*YES RPLABW *NO

*YES RPLDAT *NO
Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCVTMDLPNL command.

MDLFILE
Name of a file to which the functions containing the panel designs to be converted belong. Values for this parameter are described in the following:

*USER(default) Convert the panel designs of functions that belong to all user-defined files in the model. *ALLConvert the panel designs of functions that belong to all files in the model, including system files. *SELECTSelect file.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

469

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

MDLFUN
Name of a function whose panel designs are converted. The value for this parameter is as follows:

*ALLConvert the panel designs of all functions for the specified files.

APPCDE
Name of an application area containing the files of the functions whose panel designs are converted. The value for this parameter is as follows:

*ALL(default) Convert the panel designs of functions attached to files from all application areas.

CVTTEXT
Specifies whether narrative text for the file is included in the generated panel designs, and if so, which type of text. Values for this parameter are described in the following:

*FUNC(default) Include functional text. *NONEDo not include narrative text. *OPERInclude operational text.

FILE
Qualified name of file to contain panel designs. The value for this parameter is as follows:

YDSNPNL(default) File name.

MBR
Name of member in panel design file. The value for this parameter is as follows:

*FILE(default) The member has the same name as the file.

RPLNAV
Specifies whether to keep or replace the command key navigation that was defined for the CA 2E Toolkit panel design. Values for this parameter are described in the following:

*YES(default) The navigation is replaced.

470

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*NOThe navigation is not replaced.

RPLABW
Specifies whether to keep or replace the action bar definition that was defined in the CA 2E Toolkit panel design. Values for this parameter are described in the following:

*YES(default) The action bar definition is replaced. *NOThe action bar definition is not replaced.

RPLNAR
Used to keep or clear any narrative that was entered for the CA 2E Toolkit panel design. Values for this parameter are described in the following:

*YES(default) The narrative is cleared. *NOThe narrative is kept.

RPLDAT
Used to keep or clear any test data that was entered for the CA 2E Toolkit panel design. Values for this parameter are described in the following:

*YES(default) The test data is cleared. *NOThe test data is kept.

Notes

A library containing the model files must be present in the library list of the job that executes the YCVTMDLPNL command. The converted panel designs are placed in the nominated panel design file. The file must already exist in the specified library: new files may be created using the CA 2E Toolkit command Create Design File (YCRTDSNF). Each prototype panel design is given the name of the program source member of the function from which it is derived. A suffix is used to number the panels derived from a single CA 2E function. The converted panel designs can be prototyped using the CA 2E Toolkit command Display Panel (YDSPPNL). Refer to the CA 2E Toolkit manuals for further details.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

471

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Example
To convert all the user function panel designs to file YDSNPNL:
YCVTMDLPNL FILE(YDSNPNL)

YCVTMDLVNM (Convert Model Names) Command

Converts the implementation names of CA 2E objects within a design model. The names are updated to comply with the requirements of the HLL in which the model is to be generated. A report is produced of those names that have been changed (YCVTVNMPP$).

Required
library name YCVTMDLVNM
CA 2E Modules: *ALL

MDLLIB *CURLIB
Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCVTMDLVNM command.

MDLLIB
Name of library containing the design model whose implementation names are changed. The value for this parameter is as follows:

*CURLIBUse current library for invoking job.

Notes

The YCVTMDLVNM command examines the following implementation names in the data model, and if necessary, converts them:

472

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Access path source member names Access path format names Field or column names HLL program source member names Device file source member names Help text source member names

The nature of the conversion is controlled by the current value of the YHLLVNM model value. This dictates the rules for deciding whether a name needs converting. If the YHLLVNM model value is *CBL, then any instances of the characters @, # and $ are replaced by the appropriate character specified for the name type in the generation types table. If there is no replacement character for the name type in the table, the letter J will be used. If the value of YHLLVNM is *RPG, then any instances of the underscore character will be replaced by the quotation () character. Any other valid characters are replaced by J.

For more information about converting a model from one HLL to another, refer to Generating and Implementing Applications, Preparing for Generation and Compilation.

Example
To convert the model MYMDL:
YCVTMDLVNM MDLLIB(MYMDL)

YCVTTMUIM (Convert Help Text to UIM Panel) Command

This routine converts source that uses the existing CA 2E Toolkit help support tags (as defined in Text Management or generated by CA 2E) into UIM panel group source. Due to the difference between TM and UIM, only an approximate conversion is possible. The more your source file differs from the standard generated TM source, the less accurate the conversion will be.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

473

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Required
*LIBL/ QTXTSRC YCVTTMUIM TMSRCFILE *CURLIB/ source file name library name/
*SAME/ *LIBL/ UIMSRCFILE *CURLIB/ library name source file name QPNLSRC

*ALL SRCMBR generic* name *YES EXTHELP *NO

QTEMP/ TEMPLST MBRLST *CURLIB/ list name library name/
*NO EDIT *YES
CA 2E Modules: *ALL

*NO REPLACE *YES *NO TRUNCATE *YES

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YCVTTMUIM command.

TMSRCFILE
The qualified name of a source file containing TM help text. Values for this parameter are described in the following:

*LIBL(default) Use the library list to locate the source file. *CURLIBUse current library to locate the source file.

UIMSRCFILE
The qualified name of a source file that the converted UIM help text will be placed in. You must have *ALL rights to this file. Values for this parameter are described in the following:

*SAME(default) The library name is the same as that specified in TMSRCFILE. *LIBLThe library list is used to locate the source file. *CURLIBThe current library for the job is used to locate the source file.

474

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

SRCMBR
The generic name of the source members to convert. The name assigned to the UIM member will be the same as that of the TM member. The value for this parameter is as follows:

*ALLConvert all source members.

REPLACE
Specifies the action to be taken if a member already exists in the UIMSRCFILE. Values for this parameter are described in the following:

*NO(default) Issue an error and bypass the member. *YESChange the member and reconvert.

EXTHELP
Specifies if an extended help panel should be generated for the member. This is functionally equivalent to the existing index panel used by TM. It uses the UIM :LINK tag to provide two-way hypertext links between each panel and the extended help panel. Values for this parameter are described in the following:

*YES(default) Generate the extended help panel. *NODo not generate the extended help panel.

TRUNCATE
Allows the user to control the action on conversion when a line to be converted is too long. Values for this parameter are described in the following:

*NO(default) Excess data is continued on the next line and not truncated. *YESExcess data is truncated during conversion.

MBRLST
Specifies a target member list to be used to contain an entry for each member converted. Values for this parameter are described in the following:

TEMPLST(default) Default member name. QTEMP/Default library name. *CURLIB/The library to contain the member list is the current library.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

475

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

EDIT
Specifies whether the resulting list is to be edited at the end of the conversion process. Values for this parameter are described in the following:

*NO(default) The list is not to be edited. *YESThe list is to be edited.

Notes

The converted source can be compiled into a panel group (*PNLGRP). It can then be used with existing applications, without the need to regenerate those applications as follows: The help display routine (YDDSHPR) will check for the existence of a panel group with the same name as the help member. If it exists, it will use that panel group to display UIM help panels.

In order to supply cursor sensitive help, help panels must be related to screen areas. For full UIM, this is supplied by DDS keywords in the associated display file. For converted UIM, this must be supplied by a source member that defines a vector table. This source member can either be the original TM source member or the converted UIM source member, both of which contain the .*yv tags that define the vector table. The routine will look for this member in the same file as the original TM source member.

Example
To convert all source members in MYGENLIB\QTXTSRC beginning with UU and place output in MYGENLIB/QPNLSRC, replace any member which already exists. By default the extended help panel will be generated:
YCVTTMUIM TMSRCFILE (MYGENLIB/QTXTSRC) + UIMSRCFILE (*SAME/QPNLSRC) SRCMBR(UU*) + REPLACE (*YES)

If CSG client functions are on the job list and the client objects do not exist in the folder, entries will not be added to the job list for the client objects (the server object will always be added to the job list).

YDLTMDLLE (Delete a Model Object List Entry) Command

This command allows a user to delete a model object list entry.

476

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Required
YDLTMDLLE BOJSGT object surrogate

Optional
*MDLPRF *MDLLIB/ MDLLST model library *SELECT list name
CA 2E Modules: *ALL Job: B,I Pgm: B,I

*USER

Parameters
The following are parameters for the YDLTMDLLE command.

OBJSGT
Unique number identifier of the model object to be deleted. The value for this parameter is as follows:

Object surrogateThe surrogate number of the model object is required.

MDLLST
The qualified name of the model object list in which the entry to be deleted exists. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe name of the list. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used. library nameThe name of the model library.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

477

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Note
Both the model object list and the list entry must exist prior to running this command.

Example
To delete the model object list entry for the object identified by surrogate number 1100547 in model object list DEVRA in the first model library to be found in the current library list:
YDLTMDLLE OBJSGT( 1100547 ) + MDLLST(*MDLLIB/DEVRA )

YDLTMDLLST (Delete a Model Object List) Command

This command allows a user to delete a model object list.

Required
list name *MDLLIB/ YDLTMDLLST MDLLST model library/ *USER *SELECT
CA 2E Modules: *ALL Job: B,I Pgm: B,I

*MDLPRF

Parameters
The following are parameters for the YDLTMDLLST command.

MDLLST
The qualified name of the model object list that is to be deleted. Values for this parameter are described in the following:

list name(default) The model object list name. *MDLPRFSpecial value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command.

478

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*SELECTSpecial value indicating that the model object list is selected using an interactive display function. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library for the list. library nameThe model library name for the list.

Notes

The MDLLST must exist prior to running the command. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. There is close integration between this command and user-defined fields on the all objects model list. To provide an efficient method for clearing the user-defined fields of objects checked out to a particular model object list, part of the processing of this command is to clear the Checkout List, Checkout User, Checkout Date, Checkout Time and Checkout Status on all model object records on which the list being deleted is recorded as Checkout List.

Example
To delete model object list MYLIST from the model contained in the current library list:
YDLTMDLLST MDLLST( *MDLLIB/MYLIST )

YDLTMDLVSN (Delete Model Version) Command

This command allows the user to delete a function or a message from the model.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

479

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

Required
*OBJSGT *ARCHIVES YDLTMDLVSN OBJNAM owner name object name *MESSAGES
*OBJNAM OBJSGT object surrogate

*FUN *MSG

Optional
*DELETE *YES OPTION *HIDE *PREPASS DLTOBJSRC *NO

*MDLPRF *GENLIB *USER GENLIB *CURLIB library name list name

*GENLIB *REPLACE OUTLSTOPT *ADD library name
CA 2E Modules: *ALL Job: B,I Pgm: B,I

OUTLST *SELECT

RETAIN

*CURLIB

Parameters
The following are parameters for the YDLTMDLVSN command.

OBJNAM
The name of the object that is deleted. Values for this parameter are described in the following:

*OBJSGT(default) Single value indicating that the object surrogate number parameter is used to identify the model object. *ARCHIVESThis generic value instructs the processing program to examine all archive versions in the model. In this mode, all entries are written to the specified output list. The RETAIN parameter specifies how many archives are preserved in a particular group. object owner nameThe character name of the object which owns the object. Thus, for a function, the owning file would be entered.

480

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*MESSAGESThe internal file *Messages is the owner of the object (note that this value is only allowed for objects of type *MSG). object nameThe character name of the object. object typeThe object type of the object. *FUNObject is of type function. *MSGObject is of type message. Note that for objects of type *MSG, the owner is the *Messages file.

OBJSGT
Unique number identifier of the model object that is copied. Values for this parameter are described in the following:

OBJNAM(default) Use the object name parameter details to identify this model object. object surrogateThe surrogate number of the model object.

OPTION
This parameter provides the user with some flexibility when deleting model versions. For a model version, the user can either physically delete it or hide it by making the version non-current. When using the generic delete for archives, the user can perform a prepass, which will build a list of affected versions without actually deleting them. Only qualified versions will be processed, meaning that the version must not be used by any other model object. Values for this parameter are described in the following:

*DELETE(default) Special value meaning that versions that qualify for processing are physically deleted. *HIDESpecial value meaning that versions that qualify for processing are not deleted but made non-current. They will not, by default, be shown on model panels. If a version is already non-current it remains unaffected by this process. *PREPASSFor the *ARCHIVES processing only. Special value meaning that the archives that qualify for processing should be written to the out list but not physically deleted.

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

481

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

DLTOBJSRC
This parameter allows the user to specify that the object and source corresponding with the model design object are deleted at the same time the design object is deleted from the model. Values for this parameter are described in the following:

*YES(default) The object and source are deleted. *NOThe object and source are not deleted.

GENLIB
The name of the generation library that contains the source and object corresponding with the model object that is deleted. Values for this parameter are described in the following:

*GENLIB(default) Special value meaning that the generation library for the model is used. *CURLIBSpecial value meaning that the generation library is the current library for the job. library nameThe generation library name.

OUTLST
The name of the model object list that is to receive an entry for each archive version which satisfies the RETAIN parameter (i.e., qualifies for the delete operation). This parameter is only prompted if *ARCHIVES is specified for the OBJNAM parameter. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile details for the current user. *USERSpecial value meaning that the user profile name of the current user is used as the list name. *SELECTSpecial value meaning that an interactive select program is invoked. The output list will be selected. list nameThe name of the target list.

OUTLSTOPT
This parameter specifies the action to be taken if the output list already exists in the model. This parameter is only prompted if *ARCHIVES is specified for the OBJNAM parameter. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list is to be replaced with the output from this command.

482

Command Reference Guide

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

*ADDThe existing model object list is augmented with the output from this command.

RETAIN
This parameter specifies the number of archive versions (version type ARC) that are retained. This parameter is only prompted when the OBJNAM parameter is *ARCHIVES. The archive versions are examined in reverse chronological order, the excess number above this parameter being deleted. Values for this parameter are described in the following:

*ALL(default) All archive versions are retained. *NONENo archive versions are retained. numeric valueThe developer may specify a discreet number of versions that are retained.

Notes

It is intended that this command be used as part of a change control system. The primary purpose is for the removal of archives from the model as they become redundant with the creation of later versions. No version can be deleted if it is used by any other model object. When *ARCHIVES are being processed, all versions that are processed are written to the specified output list. If it is not possible to make a current version non-current or to delete a non-current version, the entry is flagged *ERROR.

Example
To delete the model version Edit Customer 3 from the model, accepting the default removal of object and source from the generation library for the model, enter the following:
YDLTMDLVSN OBJNAM( 'Customer' 'Edit + Customer 3' '*FUN' )

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

483

Chapter 4: Commands (YCLRMDL - YDLTOBJTBL)

YDLTOBJTBL (Delete Object Table User Space)

This command deletes all User Spaces for a 2E model. They are then rebuilt when a user enters the model again or YSNCMDL is run. This command can be used to resolve model corruption problems, or when any sort of problems with model data are encountered. This command should only be used when instructed to do so by 2E Support.

Parameters
Parameter MDLLIB Definition Library for Data Model This specifies the model for which the user spaces are deleted Specify model library name Value and Description *MDLLIB: Use the first model library found in the library list.

model-name

484

Command Reference Guide

Chapter 5: Commands (YDOCMDLACP YOPRMDLLST)

This chapter contains details for CA 2E commands YDOCMDLACP through YOPRMDLLST. These commands appear in alphabetical order and include descriptions of their functions, parameters and allowed values, notes, and examples. Each command is also accompanied by a command diagram.

YDOCMDLACP (Document Model Access Paths) Command

Documents the access path files within a design model.

Optional
*USER YDOCMDLACP MDLFILE *ALL
*NONE *ALL APPCDE application data *OPER PRTTEXT *FUNC

*ALL *NO PRTACPDTL *YES PRTACPTYP One of the following: *PHY *UPD *RTV *RSQ *SPN *QRY

*DFT BGNNEWPAG *FILE

CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDOCMDLACP command.

MDLFILE
Types of files whose access paths are documented. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

51

YDOCMDLACP (Document Model Access Paths) Command

*USER(default) List the access paths of all user-defined files in the model. *ALLList the access paths of all files in the model, including system files.

APPCDE
Name of an application area to which the files whose access paths are listed belong. The value for this parameter is as follows:

*ALL (default) List the access paths of files from all application areas.

PRTTEXT
Specifies whether narrative text for the access path is included in the generated documentation, and if so, which type of text. Values for this parameter are described in the following:

*NONE(default) Do not include narrative text. *FUNCInclude functional text. *OPERInclude operational text.

PRTACPDTL
Specifies whether the details of the access path are included in the generated documentation. Values for this parameter are described in the following:

*NO(default) Do not include full details. *YESInclude full details.

PRTACPTYP
Specifies the types of access path that are included in the generated documentation. Values for this parameter are described in the following:

*ALL(default) Include all access path types. *PHYInclude only physical access paths. *UPDInclude only update access paths. *RTVInclude only retrieval access paths. *RSQInclude only resequence access paths. *SPNInclude only span access paths. *QRYInclude only query access paths

52

Command Reference Guide

YDOCMDLAPP (Document Model Application Areas) Command

BGNNEWPAG
Specifies whether documentation for a function or file starts on a new page or not. Values for this parameter are described in the following:

*DFT(default) Do not start a new page. *FILEStart a new page for each file whose functions are documented.

Notes
A library containing the model files must be present in the library list of the job that executes the commands.

Example
To print all details about the model files in a model library:
YDOCMDLACP

YDOCMDLAPP (Document Model Application Areas) Command

Documents the application areas within a design model.

Optional
*ALL YDOCMDLAPP APPCDE *SYS application data PRTTEXT *NONE *FUNC *OPER

*NO PRTFILES *YES

CA 2E Modules: *ALL

*NO BGNNEWPAG *YES

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDOCMDLAPP command.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

53

YDOCMDLAPP (Document Model Application Areas) Command

APPCDE
Name of an application area that is documented. Values for this parameter are described in the following:

*ALL(default) List all application areas. *SYSList the system application area (this contains all files in the model).

PRTTEXT
Specifies whether narrative text for the file is included in the generated documentation, and if so, which type of text. Values for this parameter are described in the following:

*NONE(default) Do not include narrative text. *FUNCInclude functional text. *OPERInclude operational text.

PRTFILES
Specifies whether the files belonging to the application area(s) specified in the APPCDE parameter are included in the generated documentation. Values for this parameter are described in the following:

*YES(default) Include files. *NODo not include files.

BGNNEWPAG
Specifies whether documentation for an application area is to start on a new page or not. Values for this parameter are described in the following:

*NO(default) Do not start a new page. *YESStart a new page for each application area documented.

54

Command Reference Guide

YDOCMDLF (Document Model Files) Command

Notes
A library containing the model files must be present in the library list of the job that executes the YDOCMDLAPP command.

Example
To print all details about the model application areas in a model library, including functional text and files within each area:
YDOCMDLAPP PRTTEXT(*FUNC) PRTFILE(*YES)

YDOCMDLF (Document Model Files) Command

Documents the files within a design model.

Optional
*USER YDOCMDLF MDLFILE *ALL model file name
*NONE *ALL APPCDE application area *OPER *NO *NO PRTREL *YES *FULL
CA 2E Modules: *ALL Job: B,I Pgm: B,I

PRTTEXT

*FUNC

*NO PRTFUN *YES

PRTACCPTH *YES

Parameters
The following are parameters for the YDOCMDLF command.

MDLFILE
Specifies name of files you want to include in the listing. Values for this parameter are described in the following:

*USER(default) List all user-defined files in the model. *ALLList all files in the model, including system files.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

55

YDOCMDLF (Document Model Files) Command

APPCDE
Name of an application area to which the files that are listed belong. Values for this parameter are described in the following:

*ALL(default) List files from all application areas.

PRTTEXT
Specifies whether narrative text for the file is included in the generated documentation, and if so, which type of text. Values for this parameter are described in the following:

*NONE(default) Do not include narrative text. *FUNCInclude functional text. *OPERInclude operational text.

PRTREL
Specifies whether the relations that reference the file are included in the generated documentation. Values for this parameter are described in the following:

*NO(default) Do not include relations. *YESInclude relations. *FULLPrint relations and associated field entries together with details of the field entry.

PRTACCPTH
Specifies whether the names of the access paths referenced by each file are included in the generated documentation. Values for this parameter are described in the following:

*NO(default) Do not include access paths. *YESInclude access paths.

PRTFUN
Specifies whether the names of the functions that reference the file are included in the generated documentation. Values for this parameter are described in the following:

*NO(default) Do not include functions. *YESInclude functions.

56

Command Reference Guide

YDOCMDLFLD (Document Model Fields) Command

Notes
A library containing the model files must be present in the library list of the job that executes the YDOCMDLF command.

Example
To print all details about the model files in a model library:
YDOCMDLF PRTTEXT(*FUNC) PRTREL(*YES) + PRTACCPTH(*YES) PRTMSG(*YES)

YDOCMDLFLD (Document Model Fields) Command

Documents the fields within a design model. Optional
*NONE *USER YDOCMDLFLD MDLFLD *ALL *OPER PRTTEXT *FUNC

*NO PRTFLDDTL *YES

CA 2E Modules: *ALL

*NO PRTCND *YES

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDOCMDLFLD command.

MDLFLD
Specifies whether you want to omit system fields from the listing. Values for this parameter are described in the following:

*USER(default) List all user-defined fields in the model. *ALLList all fields in the model, including system fields.

PRTTEXT
Specifies whether narrative text for the fields should be included in the generated documentation, and if so, which type of text. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

57

YDOCMDLFUN (Document Model Functions) Command

*NONE(default) Do not include narrative text. *FUNCInclude functional text. *OPERInclude operational text.

PRTFLDDTL
Specifies whether you want to include full details for the fields in the generated documentation. Values for this parameter are described in the following:

*NO(default) Do not include field details. *YESInclude field details.

PRTCND
Specifies whether the names of any field conditions referenced by the fields are included in the generated documentation. Values for this parameter are described in the following:

*NO(default) Do not include conditions. *YESInclude conditions.

Notes
A library containing the model files must be present in the library list of the job that executes the YDOCMDLFLD command.

Example
To print all details about the model fields in a model library:
YDOCMDLFLD PRTTEXT(*FUNC) PRTFLDDTL(*YES) + PRTCND(*YES)

YDOCMDLFUN (Document Model Functions) Command

Documents the functions within a design model.

58

Command Reference Guide

YDOCMDLFUN (Document Model Functions) Command

Optional
*USER *ALL YDOCMDLFUN MDLFILE *SELECT (1) model file name *ALL MDLFUN model function name *ALL APPCDE application area *ALL FUNTYPE function type (2) One of the following: *EXT *INT *DEV *DFN *USR *FLD *DBF *MSG *SCR *RPT *DSP *UPD *NONE PRETTEXT *FUNC *OPER *NO PRTDEVDSN *YES *FULL
*NONE *FULL *NO PRTFUNREL *YES PRTACTDIAG *USER *USERMOD *FUN *SUMMARY

*NO PRTFUNOPT *YES

*NONE *NO PRTPARM *ALL

*ENTRY

PRTDEVSTR *YES *NONE

PRTDEVDTL

*BASIC

*NONE PRTABO *BASIC *FUN *NONE 1 FUNLVL integer PRTCHGDAT *EQ *LT *GT date *ALL

*DFT BGNNEWPAG *FILE *FUNCTION

(1) *SELECT is only valid for interactive jobs. (2) One of the CA 2E function types.
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

59

YDOCMDLFUN (Document Model Functions) Command

Parameters
The following are parameters for the YDOCMDLFUN command.

MDLFILE
Name of a file, or generic name of some files, to which the functions that are listed belong. Values for this parameter are described in the following:

*USER(default) List functions that belong to all user-defined files in the model. *ALLList functions that belong to all files in the model, including system files. *SELECTDisplay the files in the current model, one of which may be selected.

MDLFUN
Name of a function that is listed, or generic name of functions that are listed. The value for this parameter is as follows:

*ALL(default) List all functions for the specified files.

APPCDE
Name of an application area to which the files referenced by the listed functions belong. The value for this parameter is as follows:

*ALL(default) List functions that reference files from all application areas.

FUNTYPE
Types of functions you want listed. Must be one of the standard function types or a special value. Values for this parameter are described in the following:

*ALL(default) List all types of functions. *INTList only internal functions. *EXTList only external functions. *DBFList only database functions. *DEVList only device functions. *DFNList only define screen/report format functions. *FLDList only field functions.

510

Command Reference Guide

YDOCMDLFUN (Document Model Functions) Command

*MSGList only message functions. *USRList only user functions. *SCRList only display device functions. *RPTList only report device functions. *DSPList only display functions. *UPDList only edit functions. Other valuesSee the notes section for function types and classes.

PRTFUNOPT
Specifies whether the function options are included in the generated documentation. Values for this parameter are described in the following:

*NO(default) Do not print function options. *YESPrint function options.

PRTTEXT
Specifies whether any narrative text for the function is included in the generated documentation, and if so, which type of text. Values for this parameter are described in the following:

*NONE(default) Do not include narrative text. *FUNCInclude functional text. *OPERInclude operational text.

PRTPARM
Specifies whether the parameters of the listed functions are included in the listing. Values for this parameter are described in the following:

*NONE(default) Do not print any function parameters. *ENTRYInclude the entry parameters of each function in the listing. *ALLInclude the *ENTRY parameters of each function in the listing. Include the parameters used to call other functions in each function's action diagram.

PRTDEVSTR
Specifies whether the device structures of the listed functions are included in the listing. Only report design functions (types PRTOBJ and PRTFIL) have device structures. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

511

YDOCMDLFUN (Document Model Functions) Command

*NO(default) Do not print any function device structures. *YESInclude the function device structures in the listing.

PRTDEVDSN
Specifies whether the device (panel and report) designs of the listed functions are included in the listing. Values for this parameter are described in the following:

*NO(default) Do not print any function device designs. *YESInclude the function device designs in the listing.

PRTDEVDTL
Specifies whether the device details (that is, field details listed by format) of the listed functions are included in the listing. Values for this parameter are described in the following:

*NONE(default) Do not print any function device details. *BASICPrint basic details of all fields on each format of the device design. *FULLPrint details of display attributes of fields present on the device design (that is, not hidden or dropped) as well as basic details of all fields on each format of the device design.

PRTFUNREL
Specifies whether the device design relations of the listed functions are included in the listing. Values for this parameter are described in the following:

*NO(default) Do not print any function relations. *YESInclude the function relations in the listing.

PRTACTDIAG
Specifies whether the action diagrams of the listed functions are included in the listing, and if so, to what level of detail the diagrams are reported. Values for this parameter are described in the following:

*NONE(default) Do not print any action diagrams. *FULLPrint complete action diagram. *SUMMARYPrint only the summary or top level of the action diagram. *USERPrint only the user modifiable points in each action diagram.

512

Command Reference Guide

YDOCMDLFUN (Document Model Functions) Command

*USERMODPrint only the user modifications to action diagrams. *FUNPrint only the calls to other functions.

PRTABO
Specifies whether the action bar details of the listed functions are included in the listing. Ignored if PRTDEVDSN (*NO) is specified. Values for this parameter are described in the following:

*NONE(default) Do not print any function action bar details. *BASICPrint basic details of the action bars on the device design. *FULLPrint full details of the action bars on the device design.

FUNLVL
Indicates the number of invocation levels of the functions' action diagrams to print. Ignored if PRTACTDIAG(*NONE) is specified. Values for this parameter are described in the following:

1Print the action diagram of the first level function only. 2-9Print the action diagrams of the functions called by the first level function, and those called by the second level function, up to the specified level.

PRTCHGDAT
Specifies the change dates printed for the action diagrams of the listed functions. Values for this parameter are described in the following:

*NONE(default) Do not print any change dates. *ALLPrint all change dates. Otherwise, PRTCHGDAT is a list parameter made up of two elements:

Date operator: *EQ(default) Equal to *LTLess than *GTGreater than

Date (entered in system date format)

BGNNEWPAG
Specifies whether documentation for a function or file is to start on a new page or not. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

513

YDOCMDLFUN (Document Model Functions) Command

*DFT(default) Start a new page on page overflow. *FILEStart a new page for each file whose functions are to be documented. *FUNCTIONStart a new page for each function documented.

Notes

A library containing the model files must be present in the library list of the job that executes the YDOCMDLFUN command. Specifying either *BASIC or *FULL for the PRTDEVDTL parameter provides a separate summary of any attached device user source functions.

The following table shows the function groups.

Function type Change object Create object Delete object Retrieve object Define screen format Define report format Prompt record Display record 1 Display record 2 Display record 3 Edit record (1 screen)

Abbreviation *CHGOBJ *CRTOBJ *DLTOBJ *RTVOBJ *DFNSCRFMT *DFNRPTFMT *PMTRCD *DSPRCD *DSPRCD2 *DSPRCD3 *EDTRCD

Class *DBF *DBF *DBF *DBF *DFN *DFN *DEV *DEV *DEV *DEV *DEV *DEV *DEV *DEV *DEV *DEV *DEV *DEV *DEV *DEV

Sub-class *SCR *RPT *SCR *SCR *SCR *SCR *SCR *SCR *SCR *SCR *SCR *SCR *SCR *SCR *RPT *RPT

Implem. Type Display/Update *INT *INT *INT *INT *EXT *EXT *EXT *EXT *EXT *EXT *EXT *EXT *EXT *EXT *EXT *EXT *EXT *INT *DSP *DSP *DSP *DSP *UPD *UPD *UPD *DSP *DSP *UPD *DSP *UPD -

Edit record (2 screens) *EDTRCD2 Edit record (3 screens) *EDTRCD3 Select record Display file Edit file Display transactions Edit transactions Print file Print object *SELRCD *DSPFIL *EDTFIL *DSPTRN *EDTTRN *PRTFIL *PRTOBJ

514

Command Reference Guide

YDOCMDLLST (Document a Model Object List) Command

Function type

Abbreviation

Class *USR *USR *USR *USR *MSG *MSG *MSG *MSG *MSG *MSG *FLD

Sub-class -

Implem. Type Display/Update *INT *EXT *EXT *INT *EXT *INT -

Execute internal funct. *EXCINTFUN Execute external funct. Execute user program Execute user source Send error message Send status message Send information msg Send completion msg Retrieve message Execute message Derived field function *EXCEXTFUN *EXCUSRPGM *EXCUSRSRC *SNDERRMSG *SNDSTSMSG *SNDINFMSG *SNDCMPMSG *RTVMSG *EXCMSG *FUNFLD

Example
To print all details about the functions attached to all model files in a model library:
YDOCMDLFUN PRTTEXT(*FUNC) + PRTFUNPAR(*YES) PRTDEVDSN(*YES) + PRTACTDIAG(*YES)

YDOCMDLLST (Document a Model Object List) Command

This command allows a user to print the entries contained in a model object list.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

515

YDOCMDLLST (Document a Model Object List) Command

Required
*MDLPRF *MDLLIB/ YDOCMDLLST MDLFILE model library *SELECT list name *USER

*NAME *CHANGE *CHECKOUT VIEW *COMPCHG *CPYSTS *GEN

*BASIC DETAIL *FULL
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDOCMDLLST command.

MDLLST
The qualified name of the model object list that is documented. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe model object list name must be entered. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library for the list. library nameThe model library name for the list.

516

Command Reference Guide

YDOCMDLLST (Document a Model Object List) Command

VIEW
This parameter enables different data to be displayed for each list entry. It is prompted only if the DETAIL parameter is set to *BASIC. Values for this parameter are described in the following:

*NAME(default) Details are printed of the object name, attribute, type, and owner. *CHANGEIn addition to name, the change date and time details are printed. *CHECKOUTIn addition to name, the check out details are printed. *COMPCHGIn addition to name, the component change details are printed. *CPYSTSIn addition to name, the details relating to the copying of the object by the Copy Model Objects (YCPYMDLOBJ) command are printed. *GENIn addition to name, the generation details are printed.

DETAIL
The level of detail which is displayed. Values for this parameter are described in the following:

*BASIC(default) Minimal level of detail. *FULLMaximum level of detail.

Notes

The MDLLST must exist before running the command. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution.

Example
To document the model object list with the name retrieved from the user profile extension record of the current user in the model library contained in the current library list:
YDOCMDLLST MDLLST( *MDLLIB/*MDLPRF )

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

517

YDOCMDLMSG (Document Model Messages) Command

YDOCMDLMSG (Document Model Messages) Command

Documents the messages within a design model. Optional
YDOCMDLMSG
*ALL MSGPFX *USER message prefix MSGTYPE *ALL *INF *ERR *CMP *STS *EXE *RTV 6 maximum
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDOCMDLMSG command.

MSGPFX
Prefix of messages which are listed. Values for this parameter are described in the following:

*ALL (default) List all message functions in the model, including shipped messages. *USER List all user-defined message functions in the model.

MSGTYPE
Type of message function to be listed. Values for this parameter are described in the following:

*ALL (default) List all messages for the specified files. Message type One of the six message function types:

INF ERR CMP STS EXC RTV

518

Command Reference Guide

YDOCMDLREL (Document Model Relations) Command

Notes
A library containing the model files must be present in the library list of the job that executes the YDOCMDLMSG command.

Example
To print all details about the message functions in a model library:
YDOCMDLMSG

YDOCMDLREL (Document Model Relations) Command

Documents the relations within a design model.

Optional
*USER YDOCMDLREL MDLREL *ALL
*ALL *NONE PRTTEXT *FUNC *OPER RELPRTLVL *FIL *KEY *ATR *DEN PRTENT *NONE *ALL *RDR

*ALL APPCPE application code

*NONE *ALL PRTCHGDAT *EQ *LT *GT

CA 2E Modules: *ALL Job: B,I Pgm: B,I

date

Parameters
The following are parameters for the YDOCMDLREL command.

MDLREL
Listed relations. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

519

YDOCMDLREL (Document Model Relations) Command

*USER(default) List only the user-defined relations in the model. *ALLList all relations in the model including the relations that define CA 2E internal objects.

APPCDE
Name of an application area that the files referenced by the listed relations belong to. The value for this parameter is as follows:

*ALL(default) Include relations that use files from all application areas.

PRTTEXT
Specifies whether narrative text for the relations is included in the generated documentation, and if so, which type of text. Values for this parameter are described in the following:

*NONE(default) Do not include narrative text. *FUNCInclude functional text. *OPERInclude operational text.

RELPRTLVL
Specifies which types of relations you want to include in the generated documentation. Values for this parameter are described in the following:

*ALL(default) Include all relations. *FILInclude only file level relations. *KEYInclude only key level relations. *ATRInclude only field level relations. *DFInclude only Defined as relations.

PRTENT
Specifies whether the entries from file-to-file relations are included in the generated documentation. Values for this parameter are described in the following:

*NONE(default) Do not list entries. *RDRList only redirected entries. *ALLAll entries from file-to-file relations (Owned by, Refers to) are listed after the relations that give rise to them.

520

Command Reference Guide

YDOCURF (Document Unreferenced Objects) Command

PRTCHGDAT
Specifies whether the change dates for relations are printed. Values for this parameter are described in the following:

*NONE(default) Do not print any change dates. *ALLPrint all change dates. Otherwise, PRTCHGDAT is a list parameter made up of two elements:

Date operator:

*EQ(default) Equal to. *LTLess than. *GTGreater than.

Date (entered in system date format)

Notes
A library containing the model files must be present in the library list of the job that executes the YDOCMDLREL command.

Example
To print details about all model files in a model library, including the functional narrative text:
YDOCMDLREL PRTTEXT(*FUNC) RELPRTLVL(*ALL)

YDOCURF (Document Unreferenced Objects) Command

This command provides a model list of model objects that are unreferenced in the model. Note: A model object that is identified by the YDOCURF command as unreferenced within a model may be referenced from outside the model by menus, messages, user defined programs, and so on.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

521

YDOCURF (Document Unreferenced Objects) Command

Optional
*MDLLIB YDOCURF MDDLIB model library name
*ANY *ACP *ARR *CND OBJTYP *FIL *FLD *FUN *MSG

*NONE OUTLST list name

CA 2E Modules: *ALL

*REPLACE OUTLSTOPT *ADD

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDOCURF command.

MDLLIB
The name of the model library whose objects are to be analyzed. Values for this parameter are described in the following:

*MDDLIB(default) Special value meaning that the first model library found in the users current library list is used as the model library. library nameThe name of a specific model library.

OBJTYP
A list of up to six special values that may be used to select which object types should be analyzed by the command. Values for this parameter are described in the following:

*ANY(default) Special value meaning that any object type should be included in the analysis. *ACPInclude access paths in the analysis. *ARRInclude arrays in the analysis. *CNDInclude conditions in the analysis. *FILInclude files in the analysis.

522

Command Reference Guide

YDSPJOBLST (Display a Job List) Command

*FLDInclude fields in the analysis. *FUNInclude functions in the analysis. *MSGInclude messages in the analysis.

OUTLST
The name of the model object list that receives output from the command. Values for this parameter are described in the following:

*NONE(default) Special value meaning that no outlist processing is to be performed. list nameThe name of the model object list to be used as output.

OUTLSTOPT
Specifies the action to take if the output list already exists. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list should be replaced with the output from this command. *ADDThe existing model object list should be augmented with the output from this command.

Example
To create a list of unreferenced functions in the current model library in model object list, UNREFFUN.
YDOCURF OBJTYP(*FUN) OUTLST(UNREFFUN)

YDSPJOBLST (Display a Job List) Command

This command allows a user to display a CA 2E job list.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

523

YDSPJOBLST (Display a Job List) Command

Optional
*MDLPRF *MDLLIB/ YDSPJOBLST JOBLST model library *SELECT job list name *USER

*MDLPRF *OBJLIB SRCLIB *GENLIB *CURLIB source library name

CA 2E Modules: *ALL Job: I Pgm: B,I

*MDLPRF *GENLIB *GENLIB *CURLIB

Parameters
The following are parameters for the YDSPJOBLST command.

JOBLST
The qualified name of the CA 2E job list that is displayed. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the list name is retrieved from the model profile of the current user. *USERSpecial value meaning that the user profile name of the current user is used as the job list name. *SELECTSpecial value meaning that the list is selected. list nameThe name of the list that is used can be entered. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used. library nameThe name of the library.

SRCLIB
This parameter specifies the library from which source associated with job list entry is edited. Values for this parameter are described in the following:

*MDLPRF(default) Use the source library defined in the model profile associated with the current user. *OBJLIBThe source library to use is the same one as that specified for the object library in the model profile associated with the current user.

524

Command Reference Guide

YDSPMDLLST (Display a Model Object List) Command

*GENLIBUse the name of the generation library from the model value (YGENLIB) as a source library. *CURLIBUse the current library as a source library. library nameThe library name for source.

GENLIB
This parameter specifies the library in which to place compiled objects. Values for this parameter are described in the following:

*MDLPRF(default) The value is retrieved from the model profile details associated with the current user. *GENLIBRetrieve the name of the generation library from the model value (YGENLIB). *CURLIBUse the current library for invoking job.

Notes

The library specified for the job list must be a valid model library. Note that the YGENSRC job entries are displayed in chronological order at the top of the subfile, above the generate/compile requests. This allows the user to select a particular YGENSRC. If one is selected, only the requests for that YGENSRC are displayed. The status fields shown in the subfile control relate to the job list entries. If a particular YGENSRC request is selected, then the statistics relate just to that YGENSRC. Type, Act, Status and YGENSRC can be used to select records in the list for display.

Example
To display the current users job list:
YDSPJOBLST JOBLST( *MDLLIB/*USER )

YDSPMDLLST (Display a Model Object List) Command

This command provides access to a display panel to view the contents of a model object list.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

525

YDSPMDLLST (Display a Model Object List) Command

Optional
list name *MDLPRF *MDLLIB/ YDSPMDLLST MDLLST model library *USER *SELECT *DFTCPY
LODMDL
CA 2E Modules: *ALL

*ALLOBJ

*YES *NO
Job: I Pgm: B,I

Parameters
The following are parameters for the YDSPMDLLST command.

MDLLST
The qualified name of the model object list that is displayed. Values for this parameter are described in the following:

list name(default) The model object list name must be entered. *MDLPRFSpecial value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The change list value is retrieved. *ALLOBJSpecial value meaning that a model object list is not used, but that all model objects are included in the command. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. *DFTCPYSpecial value meaning that the model object list name is defaulted to YCPYLSTRFP. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library for the list. library nameModel library name for the list.

526

Command Reference Guide

YDSPMDLOD (Display Model Object Description) Command

LODMDL
Indicates whether the model environment is loaded before displaying the panel. Values for this parameter are described in the following:

*YES(default) Special value meaning that the model environment is to be loaded before displaying the panel. *NOThe model environment is to be loaded only if required to process a particular subfile option. Note that in this case:

A lock is not placed on the model before the panel is displayed. The model will be loaded for each subfile option that requires it and the model will be unloaded when returning to the display. In other words, you incur additional overhead each time you use a subfile option that requires the model to be loaded.

Notes

The MDLLST must exist before you run the command. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution.

Example
This section contains an example of the command as it might look using real data. To display model object list LST0001 from the model contained in the current library list:
YDSPMDLLST MDLLST(*MDLLIB/LST0001)

YDSPMDLOD (Display Model Object Description) Command

This command allows a user access to an interactive panel that displays the details for a given model object. Details relate to the creation and subsequent change of the object. For more information, please refer to the help text for the panel.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

527

YDSPMDLOD (Display Model Object Description) Command

Required
*OBJSGT *SELECT

YDSPMDLOD

OBJNAM

*NONE *ACP *ARRAYS object name *MESSAGES *ARR owner name *CND *FIL *FLD *FUN *MSG *APP

*OBJNAM OBJSGT object surrogate

CA 2E Modules: *ALL

*MDLLIB MDLLIB model name

Job: I Pgm: I

Parameters
The following are parameters for the YDSPMDLOD command.

OBJNAM
The name of the object whose details are displayed. This parameter consists of three elements that together identify a model object. Values for this parameter are described in the following:

*OBJSGT(default) Single value indicating that the object surrogate is to be used to identify the model object that is displayed. *SELECTSingle value indicating that the displayed object is selected using an interactive display function. object owner nameThe character name of the object that owns the object to be displayed. Thus, for a function, the owning file would be entered. *ARRAYSSpecial value for the product internal file *ARRAYS. *MESSAGESSpecial value for the product internal file *MESSAGES. object nameThe character name of the displayed object. object typeThe object type of the object. *ACPObject is of type access path. *APPObject is of type application area.

528

Command Reference Guide

YDSPMDLOD (Display Model Object Description) Command

*ARRObject is of type array. *CNDObject is of type condition. *FILObject is of type file. *FLDObject is of type field. *FUNObject is of type function. *MSGObject is of type message.

OBJSGT
Unique number identifier of the model object that is displayed. Values for this parameter are described in the following:

*OBJNAM(default) Use object name to identify the displayed model object. object surrogateThe surrogate number of the model object.

MDLLIB
The data model in which the object whose description is to be displayed resides. Values for this parameter are described in the following:

*MDLLIB(default) The model is the first one to be found in the current library list. model nameThe name of a specific data model.

Notes

A value other than *MDLLIB for MDLLIB may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. Model objects can either be identified by object name (OBJNAM) or by object surrogate key number (OBJSGT). If the OBJNAM parameter is used, the processing program must convert to surrogate key number internally. Thus, it will normally be more efficient to use the surrogate number if this value is available. The surrogate number for an object can be obtained using the Retrieve Model Object command (YRTVMDLOBJ). Model object names are structured as follows: Type ACP Name File name/Access path name/'ACP'

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

529

YDSPMDLREF (Display Model References) Command

APP ARR CND FIL FLD FUN MSG

---/Application area code/'APP' *Arrays/Array name/'ARR' Field name/Condition name/'CND' ---/File name/'FIL' ---/Field name/'FLD' File name/Function name/'FUN' *Messages/Message name/'MSG'

Example
To display the Edit Order Details function, which is owned by the order details file, enter the following:
YDSPMDLOD OBJNAM( 'Order Details' 'Edit + Order Details' *FUN)

YDSPMDLREF (Display Model References) Command

This command allows a user to display references to a list of model objects. References can be displayed, printed or converted to a model object list.

530

Command Reference Guide

YDSPMDLREF (Display Model References) Command

Required

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

531

YDSPMDLREF (Display Model References) Command

*USER *MDLLIB/ YDSPMDLREF MDLLST model library list name

* OUTPUT *MDLLST *PRINT

*MDLPRF

*MDLLST *USER OUTMDLLST *MDLPRF list name

*REPLACE OUTLSTOPT *ADD

*MDLLIB/ *MDLPRF *GENLIB/ *USER *SRCLIB/ JOBLST *LIBL/ *SELECT *CURLIB/ job list name job list name/
*MDLPRF *USER SSNLST *SELECT list name

*MDLLST *MDLLST *MDLLST

*WORKSTN

*NOMAX SCOPE *NEXT *EXTFUN FILTER

*ANY *GENOBJ *DBFFUN *ERR *EXTFUN *INTFUN *ACP *ARR *APP *CND *FIL *FLD *FUN *MSG

*YES EXCSYS *NO *YES CUROBJ *NO

532

Command Reference Guide

YDSPMDLREF (Display Model References) Command

*FIRST REASON *ALL *REASON *ANY FLAGVAL *ERROR *SELECTED

CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDSPMDLREF command.

MDLLST
The qualified name of the model object list containing the objects whose references are displayed. Values for this parameter are described in the following:

*MDLPRFSpecial value meaning that the model object list name is retrieved from the user defaults for the current user in the specified model library. list nameThe model object list name. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library. library nameThe model library name for the list.

OUTPUT
This parameter determines how the references are presented. Values for this parameter are described in the following:

*(default) References are displayed. *MDLLSTReferences are directed to a model object list. This option enables users to perform further list operations on the list entries. *PRINTReferences are printed. Note: If referenced objects are subject to filtering, then the primary object details are only printed if at least one referenced object satisfies the filtering criteria specified. This reduces the volume of output.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

533

YDSPMDLREF (Display Model References) Command

OUTMDLLST
The name of the model object list that receives output from the command. Values for this parameter are described in the following:

*MDLLST(default) Special value meaning that the output should be placed in the input list. *USERSpecial value meaning that the model object list name is the same as the name of the current user. *MDLPRFSpecial value meaning that the model object list name is retrieved from the user defaults for the current user in the specified model library. list nameThe target model object list name.

OUTLSTOPT
This parameter specifies the action to be taken if the output list already exists. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list should be replaced with the output from this command. *ADDThe existing model object list should be augmented with the output from this command.

EDIT
This parameter specifies whether the resulting output list is edited as part of processing. Values for this parameter are described in the following:

*NO(default) Editing of the list is not performed. *YESEditing of the list is performed.

JOBLST
Qualified name of job list that contains the names of source members to be generated and/or compiled. If the nominated job list does not already exist, it will be created. Values for this parameter are described in the following:

*MDLPRF(default) Retrieve the job list name from the model profile details of the current user. *USERThe job list name is the same name as the current user. *WORKSTNUse device name of current work station as list name. *SELECTDisplay a list of existing job lists, one of which may be selected. The name of the job list may be entered

534

Command Reference Guide

YDSPMDLREF (Display Model References) Command

*MDLLIB/The job list library is the first model library found in the library list. *GENLIB/Use the generation library specified in the first model found in the library list. *SRCLIB/Use the source library specified on the model profile of the current user. *LIBL/The job list library is the first model found in the library list. *CURLIB/The model library is found in the current library for the current job. The job list library can be entered.

SSNLST
This parameter specifies the session list to use while editing the model. Values for this parameter are described in the following:

*MDLPRF(default) The session list is to be retrieved from the model profile details for the current user. *USERThe session list has the same name as the current user. *SELECTAn interactive display is used to select a model object list to be used as the session list.

The name of the list can be entered. For more information on the purpose of SSNLST, refer to the Change Model Profile command (YCHGMDLPRF).

SCOPE
This parameter allows the user to control the extent to which references are traced. Values for this parameter are described in the following:

*NOMAX(default) No maximum level of expansion. *NEXTExpansion proceeds to the next level only. *EXTFUNThis option is intended for use with objects of type FUN. Expansion proceeds up to and including the first external function on each chain of references. This enables the user to determine the functions referenced by a given program.

FILTER
This parameter allows the user to specify filtering on the objects displayed. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

535

YDSPMDLREF (Display Model References) Command

*ANY(default) No filtering of objects is performed. *GENOBJOnly generatable objects are displayed. *DBFFUNOnly database functions are displayed. *ERROnly references to deleted objects are displayed. *EXTFUNExpand references down to and including the first generated function. *INTFUNOnly internal functions are displayed. Object typeA specific object type may be entered for filtering purposes. They are: *ACP, *ARR, *APP, *CND, *FIL, *FLD, *FUN, and *MSG

CMTCDE
This parameter allows the inclusion of inactive AD code in the analysis:

*YESInactive code is included. *NOInactive code is not included. *IGNCode is not examined for active/inactive status. The WRN field will not be populated. Processing of *IGN is typically much faster. *MDLVALRetrieve the value from the CA 2E model value (YCMTCDE).

EXCSYS
This parameter allows the exclusion of system objects from the analysis. System objects are the internal objects used by CA 2E such as the *Standard Header/Footer internal file. The value for this parameter is as follows:

*YES(default) System objects are excluded. *NOInclude system objects.

CUROBJ
This parameter allows the exclusion of non-current versions from the analysis. Currency only applies to objects that are supported for versioning. Values for this parameter are described in the following:

*YES(default) Only current objects are included. *NOInclude system objects.

For more information on versions, see the Working with CA 2E Model Objects chapter in the Generating and Implementing Applications guide.

536

Command Reference Guide

YDSPMDLREF (Display Model References) Command

REASON
This parameter allows the reason for the dependency between objects to be part of the filtering process. Values for this parameter are described in the following:

*FIRST(default) The processing program will note the first reason when an object is encountered. *ALLAll subsequent encounters with a given object are included. REASONA specific reason may be entered. The processing program will search for dependencies of the specified reason.

FLAGVAL
This parameter allows the input list entries to be filtered according to the value of the object selected indicator for each entry. Values for this parameter are described in the following:

*ANYNo selection processing is performed. *ERROROnly process entries flagged in error are considered. *SELECTEDOnly process selected entries are considered.

Notes

The model library specified must be a valid model library. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is not changed back after execution. If the output model list does not exist prior to running the command, it is created. If the list is printed, the display model references panel is used. This panel is described below. If the resulting list is printed, the Document Model Object list command (YDOCMDLLST) is called. The edit parameters are ignored if the running job is a batch job. The filtering parameter is applied to the expanded details. Thus, if the output is to display, the filtering may be adjusted without having to rebuild the expansion. If output is to a model list, the filtering is performed when the entries are written to the list.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

537

YDSPMDLREF (Display Model References) Command

An indented output format is used for the *PRINT option whenever this is appropriate. If the default of *FIRST is used for the REASON filter, the objects are sorted in a keyed sequence. It would be inappropriate to indent this sequence because the relationships between the objects are purely arbitrary. However, any other value for REASON will cause the processing program to examine objects strictly in the order of expansion; the indented format here clearly shows the hierarchy of dependencies to assist developers.

Reference Table
The Ref level value refers to the level of reference by a given object to the original object that is displayed on the subfile control. This value may be changed by the user and will control the data shown in the subfile. By manipulating the range of levels available, all possible reference levels can be viewed individually or in combination. The Ref type column in the subfile refers to the reason for the reference. The following table shows the possible reasons for references between model objects. Actual references to a given model object will depend upon the model object type.

Obj Type All

To Type

Ref Code *ENTRY

Reason Displayed only on the first panel when you access the YDSPMDLREF panel for a model object list rather than for a single list entry; for example, by using the YDSPMDLREF command or F22 from the YEDTMDLLST panel. It indicates that each list entry displayed has simply been updated to reflect its current state in the model; no references have been expanded. Your original list is not changed. You can now perform impact analysis on single list entries using the selection options. See also the online Help for the panel and the Impact Analysis topic in chapter 1 of Generating and Implementing Applications. For associated access path, such as the UPD access path for a given RTV. For referenced access path, such as the RTV access path on a file-to-file relation of a referring access path. For access path auxiliaries. For access path condition. For owning FIL. For access path physical entries.

Note

ACP

ACP ACP AUX CND FIL FLD

*ASSACP *REFACP *ACPAUX *ACPCND *REFFIL *PHYENT

538

Command Reference Guide

YDSPMDLREF (Display Model References) Command

Obj Type

To Type FUN

Ref Code *SELRCD *LSTCND *REFFLD

Reason For select record override function. No references. For list condition. For owning field. No references.

Note

CND

CND FLD

APP ARR

ACP FIL FLD *ARRDTL *REFFIL *ARRENT *REFFIL *SHRFIL *FILENT *MAPFLD *PARFLD *SRCFLD *RNMFLD *VRTENT *RCDEXS *RCDNFD *FLDCND *REFFLD *EXTINT *FLDUSR *INTEXT *BASED *FUNPAR *BASED *FUNPAR *ABOCND *ACTCND *DEVCND

For array entry details. For associated FIL. For array entries. For referenced FIL. For file defining a sharing level. For field appearing as an entry. For field mapping (user-defined field types). For field mapping (user-defined field types). For field mapping (user-defined field types). For renamed entry. For field as virtual entry. For record exists message. For record not found message. For condition. For domain definition. For external/internal conversion function (user-defined field type). Field-attached user source function (enabled) For internal/external conversion function (user-defined field type). For based-on access path. For function/message parameter definition. For based-on array. For function/message parameter definition. For action bar condition. For action diagram condition. For screen entry condition.

FIL

FIL FIL FLD FLD FLD FLD FLD FLD MSG MSG

FLD

CND FLD FUN FUN FUN

FUN

ACP ACP ARR ARR CND CND CND

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

539

YDSPMDLREF (Display Model References) Command

Obj Type

To Type CND DSP FIL FLD FLD FLD FLD FLD FLD FLD FLD FLD FUN FUN FUN FUN FUN FUN FUN FUN FUN FUN FUN HLP MSG SRV

Ref Code *VLDCND *DSPDTA *REFFIL *ACTION *DEVENT *FUNPDT *PARAM *REFFLD *SCRMAP *SCRPAR *SCRSRC *SCRTXT *ACTION *DFTDBF *DSLDBF *DEVSTR *DEVUSR *ENTUSR *FLDUSR *FMTUSR *RPTUSR *SCRUSR *SELRCD *HLPDTA *ACTION *FUNAUX

Reason For field validation condition. For display file details. For owning FIL. For action diagram compares. For device fields. For function/message parameter details. For action diagram parameter fields. For derived field. For screen field mapping (user-defined field types). For screen field mapping (user-defined field types). For screen field mapping (user-defined field types). For screen text field. For action diagram functions. Default database function. Deselected database function. For device structure reference. Device-attached user source function Entry-attached user source function Field-attached user source function (disabled) Format-attached user source function Report-attached user source function Screen-attached user source function For select record override function. For help file details. For action diagram message. For function auxiliary.

Note

1 3

The Note column indicates whether or not there is a reciprocal entry in the usage table by the referenced object. The numbers in the column refer to the following explanations as to why there will not be a corresponding usage entry:

540

Command Reference Guide

YDSPMDLUSG (Display Model Usages) Command

1 2 3

The referenced object is not a primary object. Reference is for object redefinition only, the relationship is already noted using *FILENT. The usage of FIL to FUN is not a useful piece of information. The usage might, however, be discernible via ACP. In other words, usage on a FIL will display any ACP objects attached to the FIL. These in turn will display any using FUN objects. The relationship between FLD and FUN represents the interdependency of these two objects on each other. The FLD object actually uses the FUN. However, the FUN is not a primary object. It is not treated as a function in its own right and is not accessible except through the FLD object. The reference of FUN to FLD for screen text is not treated as a bona fide usage since the fields involved are internal product objects only.

Example
To edit the list of generatable object references to objects existing on model object list TMPLST:
YDSPMDLREF MDLLST( *MDLLIB/TMPLST ) + OUTPUT( *MDLLST ) EDIT( *YES ) + FILTER( *GENOBJ )

YDSPMDLUSG (Display Model Usages) Command

This command allows a user to display usages of a list of model objects. Usages can be displayed, printed or converted to a model object list.

Optional

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

541

YDSPMDLUSG (Display Model Usages) Command

*USER *MDLLIB/ YDSPMDLUSG MDLLST model library/ list name

* OUTPUT *MDLLST *PRINT

*MDLPRF

*MDLLST *USER OUTMDLLST *MDLPRF list name

*REPLACE OUTLSTOPT *ADD

*MDLLIB/ *MDLPRF *GENLIB/ *USER *SRCLIB/ JOBLST *LIBL/ *SELECT *CURLIB/ job list name job list name/
*MDLPRF *USER SSNLST *SELECT list name

*YES EDIT *NO

*WORKSTN

*NOMAX SCOPE *NEXT *GENFUN *GENOBJ *DBFFUN *EXTFUN *INTFUN *ACP *ARR *APP *CND *FIL *FLD *FUN *MSG FILTER

*ANY *DBFFUN *ERR *EXTFUN *GENFUN *GENOBJ *INTFUN *ACP *ARR *APP *CND *FIL *FLD *FUN *MSG

*YES EXCSYS *NO *YES CUROBJ *NO

542

Command Reference Guide

YDSPMDLUSG (Display Model Usages) Command

*FIRST REASON *ALL REASON

*ANY FLAGVAL *ERROR *SELECTED
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDSPMDLUSG command.

MDLLST
The qualified name of the model object list containing the objects whose usages are displayed. Values for this parameter are described in the following:

*USER(default) Special value meaning that the model object list name is the same as the name of the current user. *MDLPRFSpecial value meaning that the model object list name is retrieved from the user defaults for the current user in the specified model library. list nameThe model object list name. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library. library nameThe model library name for the list.

OUTPUT
This parameter determines how the usages are presented. Values for this parameter are described in the following:

*(default) References are displayed. *MDLLSTUsages are directed to a model object list. This option enables users to perform further list operations on the list entries. *PRINTUsages are printed.

OUTMDLLST
The name of the model object list that receives output from the command. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

543

YDSPMDLUSG (Display Model Usages) Command

*MDLLST(default) Special value meaning that the output should be placed in the input list. *USERSpecial value meaning that the model object list name is the same as the name of the current user. *MDLPRFSpecial value meaning that the model object list name is retrieved from the user defaults for the current user in the specified model library. list nameThe target model object list name.

OUTLSTOPT
This parameter specifies the action taken if the output list already exists. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list should be replaced with the output from this command. *ADDThe existing model object list should be augmented with the output from this command.

EDIT
This parameter specifies whether the resulting output list is edited as part of processing. Values for this parameter are described in the following:

*NO(default) Editing of the list is not performed. *YESEditing of the list is performed.

JOBLST
Qualified name of job list that contains the names of source members to be generated and/or compiled. If the nominated job list does not already exist, it will be created. Values for this parameter are described in the following:

*MDLPRF(default) Retrieve the job list name from the model profile details of the current user. *USERThe job list name is the same name as the current user. *WORKSTNUse device name of current work station as list name. SELECTDisplay a list of existing job lists, one of which may be selected. The name of the job list may be entered. *MDLLIB/The job list library is the first model library found in the library list. *GENLIB/Use the generation library specified in the first model found in the library list.

544

Command Reference Guide

YDSPMDLUSG (Display Model Usages) Command

*SRCLIB/Use the source library specified on the model profile of the current user. *LIBL/The job list library is the first model found in the library list. *CURLIB/The model library is found in the current library for the current job. The job list library can be entered.

SSNLST
This parameter specifies the session list to use while editing the model. Values for this parameter are described in the following:

*MDLPRF(default) The session list is retrieved from the model profile details for the current user. *USERThe session list has the same name as the current user. *SELECTAn interactive display is used to select a model object list used as the session list. The name of the list can be entered.

For more information on the purpose of SSNLST, see the Change Model Profile command (YCHGMDLPRF) section in this chapter.

SCOPE
This parameter allows the user to control the extent to which usages are traced. Values for this parameter are described in the following:

*NOMAX(default) No maximum level of expansion. *NEXTExpansion proceeds to the next level only. *GENFUNExpand objects up to and including the first generatable function. *GENOBJExpand objects up to and including the first generatable object. *INTFUNExpand objects until the first internal function is encountered. *EXTFUNExpand objects until the first generatable function. object typeThe object type when expansion is to stop. Allowed object types are: *ACP, *APP, *ARR, *CND, *FIL, *FLD, *FUN, and *MSG.

FILTER
This parameter allows the user to specify filtering on the objects displayed. Values for this parameter are described in the following:

*ANY(default) No filtering of objects is performed. *DBFFUNOnly database functions are displayed.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

545

YDSPMDLUSG (Display Model Usages) Command

*ERROnly error usages are displayed; namely, usages by deleted objects. *EXTFUNOnly external functions are displayed. *GENFUNOnly generatable functions are displayed. *GENOBJOnly generatable objects are displayed. *INTFUNOnly internal functions are displayed. object typeA specific object type may be entered for filtering purposes. They are: *ACP, *ARR, *APP, *CND, *FIL, *FLD, *FUN, and *MSG.

CMTCDE
This parameter allows the inclusion of inactive AD code in the analysis:

*YESInactive code is included. *NOInactive code is not included. *IGNCode is not examined for active/inactive status. The WRN field will not be populated. Processing of *IGN is typically much faster. *MDLVALRetrieve the value from the CA 2E model value (YCMTCDE).

EXCSYS
This parameter allows the exclusion of system objects from the analysis. System objects are the internal objects used by CA 2E such as the *Standard Header/Footer internal file. Values for this parameter are described in the following:

*YES(default) System objects are excluded. *NOInclude system objects.

CUROBJ
This parameter allows the exclusion of non-current versions from the analysis. Currency only applies to objects that are supported for versioning. Values for this parameter are described in the following:

*YES(default) Only current objects are included. *NOInclude system objects.

For more information on versions, see the Working with CA 2E Model Objects chapter in the Generating and Implementing Applications guide.

546

Command Reference Guide

YDSPMDLUSG (Display Model Usages) Command

REASON
This parameter allows the reason for the dependency between objects to be part of the filtering process. Values for this parameter are described in the following:

*FIRST(default) The processing program will note the first reason when an object is encountered. *ALLAll subsequent encounters with a given object are included. REASONA specific reason may be entered. The processing program will search for dependencies of the specified reason.

FLAGVAL
This parameter allows the input list entries to be filtered according to the value of the object selected indicator for each entry. Values for this parameter are described in the following:

*ANYNo selection processing is performed. *ERROROnly process entries flagged in error are considered. *SELECTEDOnly process selected entries are considered.

Notes

The model library specified must be a valid model library. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is not changed back after execution. If the output model list does not exist prior to running the command, it is created. If the list is to be printed, the display model object references panel is used. This panel is described below. If the resulting list is to be printed, the Document Model Object list command (YDOCMDLLST) is called. The edit parameters are ignored if the running job is a batch job. The scope parameter will limit the expansion. This will normally be useful to prevent unnecessary objects from being included in the analysis. Note that a scoped expansion means that an expansion will need to be repeated if additional objects are to be included.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

547

YDSPMDLUSG (Display Model Usages) Command

The filtering parameter is applied to the expanded details. Thus, if the output is to display, the filtering may be adjusted without having to rebuild the expansion. If output is to a model list, the filtering is performed when the entries are written to the list. An indented output format is used for the *PRINT option whenever this is appropriate. If the default of *FIRST is used for the REASON filter, the objects are sorted in a keyed sequence. It would be inappropriate to indent this sequence because the relationships between the objects are purely arbitrary. However, any other value for REASON will cause the processing program to examine objects strictly in the order of expansion; the indented format here clearly shows the hierarchy of dependencies to assist developers.

Usage Table
The Usg level value refers to the level of usage of a given object to the original object that is displayed on the subfile control. This value may be changed by the user and will control the data shown in the subfile. By manipulating the range of levels available, all possible usage levels can be viewed individually or in combination. The Usg type column in the subfile refers to the reason for the usage. The following table shows the possible reasons for usages between model objects. Actual usages to a given model object depend upon the model object type.

Obj Type All

Used by Object Type

Usage Code *ENTRY

Reason Displayed only on the first panel when you access the YDSPMDLUSG panel for a model object list rather than for a single list entry; for example, by using the YDSPMDLUSG command or F20 from the YEDTMDLLST panel. It indicates that each list entry displayed has simply been updated to reflect its current state in the model; no usages have been expanded. Your original list is not changed. You can now perform impact analysis on single list entries using the selection options. See also the online Help for the panel and the Impact Analysis topic in chapter 1 of Generating and Implementing Applications. For joining access path. For associated access path.

Note

ACP

ACP ACP

*ACPENT *ASSACP

548

Command Reference Guide

YDSPMDLUSG (Display Model Usages) Command

Obj Type

Used by Object Type ACP

Usage Code *REFACP

Reason For referring access path. Subject access path is used as referenced access path due to file-to-file relation. For array detail definition. Function based on access path. For function/message parameter definition. For functions using related access path. That is, access path is present as a *REFACP and FUN uses access path, such as for validation. For association in application area. Function based-on array. For function/message parameter definition. For access path condition. Member of list condition. For field mapping (user-defined field types). Default field condition. Field condition. Action bar condition. Action diagram condition. Device entry condition. Default device entry condition. Device input override condition. Device output override condition. Action diagram parameter. For screen field mapping (user-defined field types). For owning file. For application area. For access path condition. For array entry. For entry redirection. For key/attribute entry.

Note

ARR FUN FUN FUN

*ARRDTL *BASED *FUNPAR *RELFUN

APP ARR

FIL FUN FUN

*APPFIL *BASED *FUNPAR *ACPCND *LSTCND *MAPFLD *DFTFLD *FLDCND *ABOCND *ACTCND *DEVCND *DFTDEV *INPOVR *OUTOVR *PARAM *SCRMAP *REFFIL *APPARA *ACPCND *ARRENT *ENTAUX *FILENT

CND

ACP CND FIL FLD FLD FUN FUN FUN FUN FUN FUN FUN FUN

FIL

ACP APP

2 3

FLD

ACP ARR FIL FIL

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

549

YDSPMDLUSG (Display Model Usages) Command

Obj Type

Used by Object Type FIL FIL FLD FLD FUN FUN FUN FUN FUN FUN FUN FUN FUN

Usage Code *MAPFLD *VRTENT *REFFLD *RNMFLD *ACTION *ACTCND *ACTCMP *DEVCND *DEVENT *FUNPAR *FUNPDT *PARAM *SCRMAP *SELRCD *ACPFUN *EXTINT *FLDUSR *INTEXT *ARCVSN *ACTION *DFTDBF *DEVSTR *DEVUSR *ENTUSR *FLDUSR *FMTUSR *RPTUSR *SCRUSR

Reason For field mapping (user-defined field types). For virtual entry. For domain definition. For rename by entry. For action diagram action. Action diagram condition. Action diagram compare. For device conditioning. For device entry. For function/message parameter definition. For function/message parameter detail definition. For action diagram parameter. For screen field mapping (user-defined field types). For select record override function. For access path function. For external/internal conversion function (userdefined field type). Field-attached user source function (enabled) For internal/external conversion function (userdefined field type). For archived version. For action diagram function. Default database function. For device structure usage. Device-attached user source function Entry-attached user source function Field-attached user source function (disabled) Format-attached user source function Report-attached user source function Screen-attached user source function

Note

FUN

ACP ACP FLD FLD FLD FUN FUN FUN FUN FUN FUN FUN FUN FUN FUN

550

Command Reference Guide

YDSPMDLUSG (Display Model Usages) Command

Obj Type

Used by Object Type FUN

Usage Code *SELRCD *RCDEXS *RCDNFD *ACTION *ARCVSN

Reason For select record override function. For record exists message. For record not found message. For action diagram function. For archived version.

Note

MSG

FIL FIL FUN MSG

The Note column indicates whether or not there is a reciprocal entry in the reference table by the using object. The numbers in the column refer to the following explanations as to why there will not be a corresponding reference entry: 1 2 The using object is not required by the used object as part of its definition. Thus, it is not shown in the reference table. FIL objects are not included as defining an application area because this would make the scope of APP references too large. For this reason there is no corresponding entry for the APP object type in the reference table. The reference of ACP to FLD is accomplished through the Access Path Condition (*ACPCND on the reference table). Developers will note from the table that there is no direct relationship between objects of type FLD and ACP. That is, a change to a FLD has no direct effect on the ACP objects that use it. The change is propagated through the FIL objects on which the FLD appears as a file entry. This is a valuable feature in the product, where it provides the capacity to accommodate changes to the data model. When an ACP is required for DDS source generation, or for the construction of a device design, the structure is determined dynamically, incorporating any changes that may have occurred since the last time the structure was required. The dynamic nature of ACP objects means, however, that there is no database representation available for interrogation by impact analysis. The result is that changes to a FLD impact the FILs which use it and are propagated to all ACP objects, even if the FLD is not used by each individual ACP.

3 4

Example
To print usages of objects present on model object list WRKLST in library UUMDL, including usages up to the first external function:
YDSPMDLUSG MDLLST( UUMDL/WRKLST ) + OUTPUT( *PRINT ) SCOPE( *EXTFUN )

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

551

YDSPMDLVAL (Display Model Value) Command

YDSPMDLVAL (Display Model Value) Command

Displays the model values.

Optional
*ALL *DSN *NME *GENACP YDSPMDLVAL MDLVAL *GENFUN *GENHLP *ENV *ENVPWS *VRS
CA 2E Modules: *ALL Job: I Pgm: I

Parameters
The following are parameters for the YDSPMDLVAL command.

MDLVAL
Type of model value displayed. Values for this parameter are described in the following:

*ALL(default) Display all model values. *DSNDisplay model values controlling design options. *NMEDisplay model values controlling naming options. GENACPDisplay model values controlling access path generation options. GENFUNDisplay model values controlling function generation options. *GENHLPDisplay the model values controlling help generation options. *ENVDisplay model values controlling development and run time environment options. *ENVPWSDisplay model values controlling PWS development and run time environment options. *VRSDisplay model values recording product version levels.

552

Command Reference Guide

YDUPAPPOBJ (Duplicate Application Objects) Command

For more information on the role of each model value, refer to the Change Model Value command (YCHGMDLVAL).

Example
To display all model values:
YDSPMDLVAL MDLVAL(*ALL)

YDUPAPPOBJ (Duplicate Application Objects) Command

Duplicates into a named library the application objects from Synon/2E that are required to run Synon/2E generated programs. This command is useful when you want to run an application independently of Synon/2E; that is, without the Synon/2E product library in your library list. You can, as an option, duplicate Synon/1E objects necessary to display help text and menus.

Optional
*GENLIB YDUPAPPOBJ GENLIB CURLLIB library name DUPOPT *ALL *CRT *EXEC *CUAENT *CUATXT *Y1HLP Y1MNU CSG
*ALL CRTOPT *NEW
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YDUPAPPOBJ command.

GENLIB
Name of library into which required objects are duplicated. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

553

YDUPAPPOBJ (Duplicate Application Objects) Command

*GENLIB(default) Use the default generated source library name as specified by the YGENLIB model value in the first model found in the library list. *CURLIBUse current library for invoking job.

DUPOPT
Types of application objects that are duplicated. Values for this parameter are described in the following:

*ALL(default) Duplicate all objects. *CRTOnly duplicate objects needed for compilation. *EXECOnly duplicate objects needed for execution, both for CUA Text and CUA Entry. CUAENTDuplicate objects needed for execution but without support for CUA Text. *CUATXTDuplicate objects needed for the CUA Text subset. *Y1HLPDuplicate CA 2E Toolkit objects needed for help text display. *Y1MNUDuplicate CA 2E Toolkit objects needed for menu display. *TRGDuplicate 2E trigger-related objects. *WSDuplicate 2E web service related objects.

CRTOPT
Duplicate existing objects option. Values for this parameter are described in the following:

*ALL(default) Duplicate all objects. Replace any existing objects with updated versions. *NEWOnly duplicate objects that do not already exist in the destination library.

Notes

You should implement this command over your generation library or over a copy of your generation library. The source for the CA 2E objects is supplied in the Synon/2E shipped source library.

554

Command Reference Guide

YEDTCPYLST (Edit Model Object List for Copy) Command

Example
To duplicate the CA 2E- and CA 2E Toolkit-required objects into generation library MYGEN:
YDUPAPPOBJ GENLIB(MYGEN)

For a diagram illustrating the entries of the two intersecting lists, see the YOPRMDLLST command in this chapter. You can also invoke this command using its short form, Y2

YEDTCPYLST (Edit Model Object List for Copy) Command

Calls an interactive program to edit a model object list that specifies the model objects that are to be copied between models.

Optional
*MDLPRF *MDLLIB/ YEDTCPYLST MDLLST *CURLLIB/ library name/ *DFTCPY *USER *SELECT model list name
*NO CREATE *YES
CA 2E Modules: *ALL

*NO BUILD *YES

Job: I Pgm: I

Parameters
The following are parameters for the YEDTCPYLST command.

BUILD
Build list option. Values for this parameter are described in the following:

*NO(default) Edit an existing model list. *YESInvoke the command Build Model List (YBLDMDLLST) to build (populate) a new list before editing it.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

555

YEDTDFTATR (Edit Default Display Attributes) Command

Notes
Calls an interactive program to edit a model object list for a design model. The model list can subsequently be used by the command Copy Model Objects (YCPYMDLOBJ):

To determine which CA 2E objects from the source model are copied to another model. To obtain an alternative name to give to a CA 2E object in the destination model to which it is copied.

Example
To edit a model object list called MYLIST in model library MYNEWMDL:
YEDTCPYLST MDLLST(MYNEWMDL/MYLST)

YEDTDFTATR (Edit Default Display Attributes) Command

Calls an interactive program to edit the default display attributes given to fields on screen designs created with CA 2E.

Optional
*MDLLIB/ YEDTDFTATR MDLLIB *CURLLIB/ library name/
CA 2E Modules: *ALL Job: I Pgm: I

Parameters
The following are parameters for the YEDTDFTATR command.

MDLLIB
Name of library containing the name of a design model for which the default attributes are changed. Values for this parameter are described in the following:

*MDLLIB(default) Use the first model library found in the library list. *CURLIBUse current library for invoking job.

556

Command Reference Guide

YEDTMDL (Edit Model) Command

Notes
The display attributes are used when creating new designs or when adding new fields to existing screen designs. The field attributes of existing fields on existing designs are not changed. You can override the display attributes of an individual field using the screen editor (Edit Screen Field Display Attributes display).

Example
To call the program to change the display attributes:
YEDTDFTATR

A panel will appear with values that can be altered.

YEDTMDL (Edit Model) Command

Calls an interactive program to enter and edit the first CA 2E model in your library list.

Short Form
Y2

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

557

YEDTMDL (Edit Model) Command

Long Form
Optional
*DSNR *MDLLIB YEDTMDL USER *PGMR *USER
*MDLLIB/ *MDLPRF *GENLIB/ *USER *SRCLIB/ JOBLST *LIBL/ *SELECT *CURLIB/ job list name library name/
*EDTDBREL *EDTMDLLST ENTRY *NONE *SERVICES SSNLST *SELECT model list name *MDLPRF *USER

MDLLIB model library name

*WORKSTN

*MDLPRF *USER *MDLVAL OPNACC *NO *SELECT model list name

CA 2E Modules: *ALL Job: I Pgm: I

MDLLST

*ALLOBJ

Parameters
The following are parameters for the YEDTMDL command.

USER
Type of user. Values for this parameter are described in the following:

*DSNR(default) A designer can change any aspect of the model, including the database. *PGMRA programmer can add or change any functions that are in the model, but cannot alter the relations, files or fields. *USERA user can view all aspects of the model but cannot change any design objects. This class of user is useful to allow the data model to be examined without the possibility of change.

558

Command Reference Guide

YEDTMDL (Edit Model) Command

MDLLIB
This parameter specifies the data model that is edited. Values for this parameter are described in the following:

*MDLLIB(default) The model to be edited is the first one found in the current job's library list. model nameThe model library name.

JOBLST
Qualified name of job list that contains the names of source members to be generated and/or compiled. If the nominated job list does not already exist, it will be created. Values for this parameter are described in the following:

*MDLPRF(default) Retrieve the job list name from the model profile details of the current user. *USERThe job list name is the same name as the current user. *WORKSTNUse device name of current workstation as list name. *SELECTDisplay a list of existing job lists, one of which may be selected. The name of the job list can be entered. *MDLLIB/The job list library is the first model library found in the library list. *GENLIB/Use the generation library specified in the first model found in the library list. *SRCLIB/Use the source library specified on the model profile of the current user. *LIBL/The job list library is the first model found in the library list. *CURLIB/The model library is found in the current library for the current job. The job list library can be entered.

ENTRY
This parameter provides the user with multiple entry points to the specified model. Values for this parameter are described in the following:

*EDTDBREL(default) The first panel to be accessed is the Edit Database Relations panel. *EDTMDLLSTThe mode of entry to the model is via the Edit Model List panel. If this value is specified, the MDLLST parameter specifies the model list that is edited. *SERVICESThe services menu is the first panel accessed.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

559

YEDTMDL (Edit Model) Command

*NONEThis option can be used to establish a model environment but without any particular entry to the model. In this case the model environment is started and the developer is presented with the Command Entry panel. Numerous commands require the model environment to be active and will check to ensure that it is active when invoked. These commands will adopt an already active environment. Thus, if a series of commands are run, it will be more efficient to use this option before executing such commands. Another advantage of this option is that the lock applied to the model will be established for the entire session, preventing interference by another developer.

SSNLST
This parameter specifies the session list to use while editing the model. Values for this parameter are described in the following:

*MDLPRF(default) The session list is retrieved from the model profile details for the current user. *USERThe session list has the same name as the current user. *SELECTAn interactive display is used to select a model object list to be used as the session list.

The name of the list can be entered. For more information on the purpose of SSNLST, refer to the Change Model Profile command (YCHGMDLPRF).

OPNACC
This parameter enables the current user to override to *NO (if authorized) the Open Access model value. The intention with this parameter is to provide a *DSNR with the opportunity to gain exclusive access to the data model. Values for this parameter are described in the following:

*MDLVAL(default) Access to the model is controlled by the current model value for Open Access. *NOThis value can be used to set the Open Access model value to exclude any concurrent *DSNR activity in the model and to exclude users of any other class.

For more information on Open Access, see the Change Model Value command (YCHGMDLVAL) in this chapter and the Creating and Managing Your Model chapter in the CA 2E Administrator Guide.

560

Command Reference Guide

YEDTMDL (Edit Model) Command

MDLLST
The qualified name of the model object list that is edited. Values for this parameter are described in the following:

*USERThe list to be edited has the same name as the current user. *ALLOBJThe all objects list is to be edited. *SELECTSpecial value indicating that the model object list is selected using an interactive display function.

Notes

The model can either be set up to allow concurrent *DSNRs and *PGMRs/*USERs into the model by setting the model value YOPNACC to *YES, or the model value can be left as *NO where either a single *DNSR or multiple *PGMRs/*USERs can be in the model concurrently. To add and remove permanent locks, or to change the Open Access (YOPNACC) model value, you must have all rights to the data model. (Designer with locks capability). To edit a model as a user of type *DSNR, you must have at least all rights except for existence to the model. Generally the most convenient way to arrange this is to grant all rights to all the objects in the model library (the default), and then to control access to the model by granting or revoking rights to use the data area YMDLLIBRFA in the model library. The YEDTMDL command checks the user's authority to this data area before allowing entry to the model. For example, to revoke all rights to user profile IVAN to edit or view a model MYMDL:
RVKOBJAUT OBJ(MYMDL/YMDLLIBRFA) + OBJTYPE(*DTAARA) USER (IVAN) AUT(*ALL)

Or to grant user profile IVAN rights to an edit model MYMDL as designer with lock capability:
GRTOBJAUT OBJ(MYMDL/YMDLLIBRFA) + OBJTYPE(*DTAARA) USER(IVAN) AUT(*ALL)

To override the model value YOPNACC (represented in the command by OPNACC) by specifying *NO, you must have all rights to the data area YOPNACCRFA. Access rights to YOPNACCRFA can be assigned or revoked in the same way as above. Should you wish to change the YOPNACC value temporarily just for the duration of the session, you must synchronize the model on exit.

Examples
To edit a model as a designer:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

561

YEDTMDLLST (Edit Model Object List) Command

YEDTMDL

To edit a model as a programmer, using a list named after the current device name:
YEDTMDL USER(*PGMR) JOBLST(*WORKSTN)

YEDTMDLLST (Edit Model Object List) Command

This command allows a user to edit model object list entries.

Optional
*MDLPRF *USER *MDLLIB/ *ALLOBJ YEDTMDLLST MDLLST *CURLIB/ *SELECT model library name/ *SESSION model list name
*DSNR USER *PGMR *USER

*MDLLIB/ *MDLPRF *GENLIB/ *USER *SRCLIB/ JOBLST *LIBL/ *SELECT *CURLIB/ job list name job list name/
*MDLPRF *USER SSNLST *SELECT list name

*WORKSTN

*NO CREATE *YES

CA 2E Modules: *ALL

*NO BUILD *YES

Job: I Pgm: I,B

Parameters
The following are parameters for the YEDTMDLLST command.

562

Command Reference Guide

YEDTMDLLST (Edit Model Object List) Command

MDLLST
The qualified name of the model object list that is edited. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. *ALLOBJSpecial value meaning that all model objects are edited. In this mode, the objects displayed are not list entries, but the actual model objects themselves. *USERSpecial value meaning that the model object list name is the same as the name of the current user. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. *SESSIONSpecial value meaning that the session list named on the current user's model profile is edited. list nameThe name of the list that is worked with. *MDLLIB/The model library is the first model found in the library list. *CURLIB/The model library is found in the current library for the current job. library nameThe model library name can be entered. If this is not the highest model library in the library list, the library list is switched. The list is returned to its original state at the end of processing.

USER
This parameter specifies the user class of the session. Values for this parameter are described in the following:

*DSNR(default) The edit session is performed as a designer user of the model. *PGMRThe edit session is performed as a programmer user of the model. *USERThe session is to be display only.

JOBLST
Qualified name of job list that contains the names of source members to be generated and/or compiled. If the nominated job list does not already exist, it will be created. Values for this parameter are described in the following:

*MDLPRF(default) Retrieve the job list name from the model profile details of the current user.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

563

YEDTMDLLST (Edit Model Object List) Command

*USERThe job list name is the same name as the current user. *WORKSTNUse device name of current work station as list name. *SELECTDisplay a list of existing job lists, one of which may be selected. The name of the job list can be entered. *MDLLIB/The job list library is to be the first model library found in the library list. *GENLIB/Use the generation library specified in the first model found in the library list. *SRCLIB/Use the source library specified on the model profile of the current user. *LIBL/The job list library is the first model found in the library list. *CURLIB/The model library is found in the current library for the current job.

The job list library can be entered.

SSNLST
This parameter specifies the session list to use while editing the model. Values for this parameter are described in the following:

*MDLPRF(default) The session list is retrieved from the model profile details for the current user. *USERThe session list has the same name as the current user. *SELECTAn interactive display is used to select a model object list that is used as the session list.

The name of the list can be entered. For more information on the purpose of SSNLST, see the Change Model Profile (YCHGMDLPRF) command section in this chapter.

CREATE
This parameter defines whether the list is created if it does not already exist prior to running the command. Values for this parameter are described in the following:

*NO(default) The list is not created if it does not already exist when the command is invoked. *YESThe list is created if it does not already exist.

564

Command Reference Guide

YEDTMDLPRF (Edit Model Profile) Command

BUILD
Indicates whether the specified list is built, if it does not exist, or added to if it does exist. Values for this parameter are described in the following:

*NO(default) The list is not built. *YESThe Build Model Object List command (YBLDMDLLST) is prompted to create or augment the list.

Notes

The *ALLOBJ value for model object list provides the user with the edit panel functionality over all the model objects. If *YES is specified for BUILD, the Build Model Object List command (YBLDMDLLST) is prompted. The BUILD parameter is ignored if *ALLOBJ is specified for MDLLST. The interactive display for this command is documented separately. Note: For more information on the YEDTMDLLST interactive display, see the Managing Model Objects chapter in the Generating and Implementing Applications guide.

The user class that is adopted has implications for the lock applied to the model. Note: For more information on the locks applied, see details relating to the Open Access model value in the Change Model Value (YCHGMDLVAL) command section in this chapter, and the Creating and Managing Your Model chapter in the CA 2E Administrator Guide.

Example
To edit the model object list referenced on the current user's model profile in the first model library in the current library list:
YEDTMDLLST MDLLST( *MDLPRF )

YEDTMDLPRF (Edit Model Profile) Command

A model profile is created for each user in each data model. It records information used by several commands, for control and defaulting purposes. This command allows the user to edit the data stored for a specified user.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

565

YEDTNXTMNC (Edit Next Mnemonics) Command

Required
*USER YEDTMDLPRF MDLPRF model profile name
CA 2E Modules: *ALL Job: I Pgm: I

Parameters
The following are parameters for the YEDTMDLPRF command.

MDLPRF
The name of the model profile that is edited. Values for this parameter are described in the following:

*USER(default) Special value indicating that the model profile of the current user is edited. model profile nameThe name of the model profile to be edited can be entered.

Notes

The first model library in the current library list is used to find the specified model profile. If the model profile does not exist, it is created. A special profile, YSYS, is used to provide default values for a new model profile.

Example
To edit the model profile Y2PGMR enter the following:
YEDTMDLPRF MDLPRF( Y2PGMR )

YEDTNXTMNC (Edit Next Mnemonics) Command

This command calls an interactive program to edit the next type mnemonics to be used when all autonames are used up for the given types. It requires an exclusive lock on the model. If multiple models use the same naming library, this command will not lock those other models, so it is up to the designer to ensure that no one is using the other models.

566

Command Reference Guide

YEXCMDLLST (Execute a Model Object List) Command

Required
*MDLLIB YEDTNXTMNC MDLLIB *CURLIB
CA 2E Modules: *ALL Job: I Pgm: I

Parameters
The following are parameters for the YEDTNXTMNC command.

MDLLIB
Name of library containing the YALCVNMRFP file associated with the model, usually the design model library. Values for this parameter are described in the following:

*MDLLIB(default) Use the first model library found in the library list. *CURLIBUse the current library for invoking the job.

Example
To call an interactive program to edit the type mnemonics for automatic naming in the current model library:
YEDTNXTMNC

YEXCMDLLST (Execute a Model Object List) Command

This command allows a user to perform some action with each of the entries contained in a model object list. Substitution variables are provided to include object related data from a particular list entry in the command to be executed. For a list of supported values, see details relating to the CMD parameter.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

567

YEXCMDLLST (Execute a Model Object List) Command

Required
YEXCMDLLST CMD command string
*MDLPRF *MDLLST/ MDLLST model library/ *SELECT list name
*NONE ERRLVL *NOMAX number

*USER

*NONE *FLAGERR UPDLST *FLAGOK *RMVERR *RMVOK

*NO *NONE INCAUX *YES *GEN USROPT user option

*CMD RQSDTA *USROPT request data

*MDLPRF OPTFIL *LIBL/ file name library name/

*MDLPRF OPTMBR *FILE member name

*ANY FLAGVAL *ERROR *SELECTED

CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YEXCMDLLST command.

CMD
The command string containing the details of the command that is executed for each entry in the model object list.

568

Command Reference Guide

YEXCMDLLST (Execute a Model Object List) Command

Note: For convenience, this parameter is a command string (*CMDSTR). This allows the command that is to be executed to be prompted and syntaxchecked prior to execution. In some instances this prevents substitution variables from being defined for a given parameter, such as making it impossible to specify the object type (&YT) in a parameter that has a fixed set of allowed values. When this happens you must use the RQSDTA parameter to specify the command to be executed. The following substitution variables are supported:

&YNObject name, 25 character string. &Y@Object surrogate, 7 decimal. &YTObject type, 3 character (FIL, FUN, ACP, etc). &YAObject attribute, 3 character (RPG, INF, STS, RTV, etc). &YOObject owner name, 25 character string. &YWObject owner surrogate, 7 decimal. &YYObject owner type, 3 character string. &YRObject group surrogate, 7 decimal. &YMModel list name, 10 character string. &YIObject implementation name, 10 character string. &YPObject promotion type, 3 character (ADD, CHG, GEN, etc). &YSObject SEU type, 10 character (RPG, DSPF, PRTF, etc). &YUUser name, 10 character. &YLModel library name, 10 character. &YCUser option text. The text is retrieved from the specified user options member. &YGObject change type, 8 character (*PRIVATE, *PUBLIC, etc). &YFFunction type, 10 character (EXCEXTFUN, EDTRCD, etc). &YZAssimilated file, a 1-character string set to Y or N. Indicates whether the FIL or owning FIL object is an assimilated file from an external database.

MDLLST
The qualified name of the model object list that is executed. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The change list value is retrieved.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

569

YEXCMDLLST (Execute a Model Object List) Command

*USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe model object list name must be entered. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library for the list. library nameThe model library name for the list can be entered.

ERRLVL
The number of errors tolerated by the command can be specified. Values for this parameter are described in the following:

*NONE(default) No errors allowed. The command will stop at the first error encountered. *NOMAXThere is no limit to the number of errors. number of errorsThe number of errors can be specified.

UPDLST
List update option. Values for this parameter are described in the following:

*NONE(default) The list entries are not updated. *FLAGERRIf an error occurs during processing of a list entry, the entry is flagged. The value to use is specified by the OUTFLAGVAL parameter. This value may be the subject of a later filtering operation. *FLAGOKIf an error does not occur during processing of a list entry, the entry is flagged. The value to use is specified by the OUTFLAGVAL parameter. This value may be the subject of a later filtering operation. *RMVERRIf an error occurs during processing of a list entry, the entry is removed from the list. *RMVOKIf the processing of a list entry completes without error, the entry is removed from the list.

RQSDTA
The request data command string containing the details of the command that is executed for each entry in the model object list. For a list of supported substitution variables, see details relating to the CMD parameter. Values for this parameter are described in the following:

570

Command Reference Guide

YEXCMDLLST (Execute a Model Object List) Command

*CMD(default) The command string parameter contains the request to be executed. *USROPTThe request data command string is retrieved from the user options file/member specified using the user option parameters.

INCAUX
This parameter lets you choose whether or not to include object auxiliaries, such as the display and help members for an interactive function, in the processing. Values for this parameter are described in the following:

*NO(default) Auxiliaries are not included in processing. *YESAuxiliaries are included in processing. *GENAuxiliaries are only included in processing if they are currently generatable as part of the normal generation of the access path or function. Note: For functions that have help text, which auxiliaries are included in processing when INCAUX is set to *GEN is affected by the setting of the YGENHLP model value (or the corresponding GENHLP function option). The YGENHLP model value specifies whether the function only (*NO), the help text only (*ONLY), or both (*YES) are to be generated.

If YGENHLP IS *NO, the help auxiliary is excluded from YEXCMDLLST processing. If YGENHLP is *ONLY, only the help auxiliary is included in processing. If YGENHLP is *YES, all generatable auxiliaries are included. YGENHLP has no effect on functions that do not have help text.

USROPT
Two character user-defined option identifying a record in the specified userdefined options file. This option contains user option text for substitution in the RQSDTA command string. The value for this parameter is as follows:

*NONE(default) No user-defined option text is used.

OPTFIL
Qualified name of the file containing the user-defined option text. The value for this parameter is as follows:

*MDLPRF(default) Single value meaning that the value for the user option file is retrieved from the model profile details for the current user.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

571

YEXCMDLLST (Execute a Model Object List) Command

OPTMBR
Name of the member containing the user-defined option text. Values for this parameter are described in the following:

*MDLPRF(default) Single value meaning that the value for the user option file is retrieved from the model profile details for the current user. *FILEThe member has the same name as the file.

FLAGVAL
This parameter allows list entries to be selected for execution. Values for this parameter are described in the following:

*ANY(default) Execute all list entries. *ERROROnly entries flagged in *ERROR are executed. *SELECTEDOnly *SELECTED entries are executed.

Notes

The MDLLST must exist prior to running the command. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. If *USROPT is specified for parameter RQSDTA, then the USROPT parameter cannot be *NONE. Substitution variables are available to insert details relating to a particular model object list entry into the command string. The substitution prefix & or @ can be used and an alternative character can be defined in the Synon/1E data area YPEXCHA (note that the Synon/1E Edit Data Area command (YEDTDTAARA) may be used to change this value). Note that object owner name will be returned as *Arrays for Array objects, *Messages for Message objects, the object name for model file objects and *NONE for objects that do not have an owner, such as FLD objects.

Example
To print each function by executing model object list IM0033 from the model contained in the current library list with the Document Model Functions command (YDOCMDLFUN):
YEXCMDLLST CMD( YDOCMDLFUN + MDLFILE(&YO) MDLFUN(&YN) ) MDLLST + (*MDLLIB/IM0033 )

572

Command Reference Guide

YEXCSQL (Execute SQL Statements) Command

YEXCSQL (Execute SQL Statements) Command

Prepares and executes SQL/400 statements contained in a source file member.

Required
*CURLIB YEXCSQL OBJLIB library name

Optional
*LIBL/ QSQLRSRC SRCFILE *CURLIB/ library name/ source file name

*FIRST MBR member name *SQL NAMING *SYS

CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YEXCSQL command.

OBJLIB
Collection in which to place SQL/400 statements. Values for this parameter are described in the following:

*CURLIB(default) Use current library for invoking job. library nameSpecific library name.

SRCFILE
Qualified name of file from which SQL statements are processed. Values for this parameter are described in the following:

*LIBL(default) Libraries named in the job library list to be processed. *CURLIBCurrent library for the job to be processed. library nameSpecific library name.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

573

YEXCWSIPDD (Execute WSIPDD file) Command

QSQLRSRC(default) SQL statements are in the QSQLRSRC source file. source file nameSpecific name of source file containing the SQL statements.

MBR
Member name of source file to be executed. Values for this parameter are described in the following:

*FIRST(default) Use first member in source file. member nameName of specific member in source file.

NAMING
Naming convention used for naming the objects in SQL statements. Values for this parameter are described in the following:

*SQL(default) Use SQL naming convention (collection-name.tablename). *SYSUse system naming convention (library-name/file-name).

Example
To apply SQL/400 statements, stored in file QSQLSRC, to SQL/400 collection, MYLIB:
YEXCSQL OBJLIB(MYLIB) SRCFILE(QSQLSRC)

YEXCWSIPDD (Execute WSIPDD file) Command

Executes a Web Service Instance Portable Deployment Data file (WSIPDD), to deploy web service instances. The WSIPDD file should have been populated by the CA 2E YPOPWSIPDD command. Typically the WSIPDD file is then moved to a different machine to be executed by the YEXCWSIPDD command. Notes:

Portable deployment does not require CA 2E or 1E to exist on the remote machine, on which the YEXCWSIPDD command is running. However, the YEXCWSIPDD command does require certain application objects to exist on the machine on which the command is running. These objects can be created in a target library using the YDUPAPPOBJ command (see the *WS argument for the DUPOPT) parameter. The YEXCWSIPDD command takes a WSIPDD file as an input.

574

Command Reference Guide

YEXCWSIPDD (Execute WSIPDD file) Command

The input WSIPDD file is always called YWSIPDDRFP, but the location is specified on the WSIPDDLIB parameter. For each record in the WSIPDD file with an ACTION flag of 'I' a web service instance will be deployed by the YCRTWS command. The Target parameters on the YEXCWSIPDD command allow the WSIPDD web service instance data to be overridden when deploying. If a web service instance is successfully deployed as a result of the YEXCWSIPDD command instance record's Action flag is updated to BLANK. The YINZWSIPDD command can be used to reset the WSIPDD Action flag.

Parameters
The following are parameters for the YEXCWSIPDD command.

WSIPDDLIB
The name of the library in which the input WSIPDD file resides. Values for this parameter are described in the following:

*GENLIBSpecial value representing the model's generation library. nameSpecify the library containing the YWSIPDDRFP/00L files.

Note: The WSIPDD file will typically have been populated by the YPOPWSIPDD command.

TMACHINE
Indicates whether WSIPDD web service instance information should be overridden when deploying. Values for this parameter are described in the following:

*INSTANCENo overriding is applied. WSIPDD web service instance information is used to deploy a web service instance. *CURRENTThe WSIPDD web service instance Machine name is overridden to *CURRENT when deploying. nameThe WSIPDD web service instance Machine name is overridden to the named value, when deploying.

TSERVER
Indicates whether WSIPDD web service instance information should be overridden when deploying. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

575

YEXCWSIPDD (Execute WSIPDD file) Command

*INSTANCENo overriding is applied. WSIPDD web service instance information is used to deploy a web service instance. character valueThe WSIPDD web service instance Server name is overridden to the named value, when deploying.

Note: Server name must match (case sensitive) with the name of the actual application server.

TSERVICE
Indicates whether WSIPDD web service instance information should be overridden when deploying.

*INSTANCENo overriding is applied. WSIPDD web service instance information is used to deploy a web service instance. nameThe WSIPDD web service instance Service name is overridden to the named value, when deploying.

TGTOBJLIB
Indicates whether WSIPDD web service instance information should be overridden when deploying. Values for this parameter are described in the following:

*INSTANCENo overriding is applied. WSIPDD web service instance information is used to deploy a web service instance. nameThe WSIPDD web service instance target object Library name is overridden to the named value, when deploying.

TUSRPRF
Indicates whether WSIPDD web service instance information should be overridden when deploying. Values for this parameter are described in the following:

*INSTANCENo overriding is applied. WSIPDD web service instance information is used to deploy a web service instance. nameThe WSIPDD web service instance target user Profile name is overridden to the named value, when deploying.

TRTLIBL
Indicates whether WSIPDD web service instance information should be overridden when deploying. Values for this parameter are described in the following:

576

Command Reference Guide

YFLTMDLLST (Filter a Model Object List) Command

*INSTANCENo overriding is applied. WSIPDD web service instance information is used to deploy a web service instance. nameThe WSIPDD web service instance target runtime library list is overridden to the name value, when deploying.

YFLTMDLLST (Filter a Model Object List) Command

This command allows a user to remove unwanted entries from a model object list. An outlist capability allows users to filter entries to an alternative list leaving the input list unchanged by the filtering process.

Required
*SELECT YFLTMDLLST FILTER *OMIT

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

577

YFLTMDLLST (Filter a Model Object List) Command

Optional

578

Command Reference Guide

YFLTMDLLST (Filter a Model Object List) Command

*MDLPRF *ALLOBJ *MDLLIB/ MDLLST model library/ *SELECT list name

*NONE *MDLPRF OUTLST *USER list name OUTLSTOPT *ADD *REPLACE

*USER

*ANY OBJNAM *ANY *NONE *ARRAYS *MESSAGES owner name object name *ANY *ACP *APP *ARR *CND *FIL *FLD *FUN *MSG

*ANY LSTDATE *CRT *CHG *GEN *CHK *EQ *QDATE *GT date *LT *NE time *ANY

*ANY OBJDATE *CRT *CHG *GEN *CHK *IMP

*ANY CHGUSR *CURRENT user name

*EQ date *GT *LT *NE date time *QDATE *ANY time

*ANY *NONE ACTRQD *ALL *GEN *EDT CUROBJ *ANY *YES *NO

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

579

YFLTMDLLST (Filter a Model Object List) Command

*ANY *ANY *PUBLIC SYSOBJ *YES *NO *GEN

*ANY *ANY *ADD IPCPRC *YES *NO *GEN *ANY *ANY *DEV VSNTYP *PRD *NO *ARC *ANY *CURRENT CHKUSR *NONE user name *ANY *CURRENT CHKLST *NONE list name
*ANY CPYOBJ *SELECTED *NONE CPYRQD *ANY *SELECTED *NONE

CHGTYP *PRIVATE

PRMTYP *CHG

VSNSNC

*YES

*ANY CHKSTS value

*ANY CPYSTS *NEW GENATR

*ANY (1) general attribute type

*ANY OBJATR object attribute

*ANY FLAGVAL *ERROR *SELECTED *SAME OUTFLAGVAL *NONE *SELECTED
*SAME OUTCPYOBJ *NONE *SELECTED

(1) The following general attribute types are valid: *ANY, *OBJDLT, *GENFUN, *GENOBJ, *DBFFUN, *DEVFUN, *DSPFUN, *EDTFUN, *EXTFUN, *INTFUN, *PRTFUN, *CHGOBJ, *CRTOBJ, *DLTOBJ, *DSPFIL, *DSPRCD, *DSPTRN, *EDTFIL, *EDTRCD, *EDTTRN, *EXCEXT, *EXCINT, *PMTRCD, *PRTFIL, *PRTOBJ, *SELRCD, *USRPGM, *USRSRC.

CA 2E Modules: *ALL

Job: B,I Pgm: B,I

580

Command Reference Guide

YFLTMDLLST (Filter a Model Object List) Command

Parameters
The following are parameters for the YFLTMDLLST command.

FILTER
Type of filtering to apply to the model object list entries. Values for this parameter are described in the following: *SELECT(default) Keep entries that satisfy all the filter conditions. *OMITReject entries that satisfy all the filter conditions.

DLLST
The qualified name of the model object list that is filtered. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The change list value is retrieved. *USERSpecial value meaning that the user profile name of the current user is used as the list name for the target of the command. *ALLOBJSpecial value meaning that a model object list is not used, but that all model objects are included in the command. If this value is specified for MDLLST, then an OUTLST must also be specified. *SELECTSpecial value indicating that the model object list is selected using an interactive display function. list nameThe name of the list to be filtered. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used. library nameThe name of the model library.

OUTLST
The name of the target model object list for entries that satisfy the filter. Values for this parameter are described in the following:

*NONE(default) Special value meaning that no outlist processing is performed. In this case, all changes are made to the input list. *MDLPRFSpecial value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The outlist value is retrieved.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

581

YFLTMDLLST (Filter a Model Object List) Command

*USERSpecial value meaning that the user profile name of the current user is used as the list name. list nameThe name of the target list.

OUTLSTOPT
This parameter specifies the action taken if the outlist specified in the OUTLST parameter already exists in the model. Values for this parameter are described in the following:

*REPLACE(default) The existing model object list is replaced with the output from this command. *ADDThe existing model object list is augmented with the output from this command.

OBJNAM
The object name details on which to filter. This parameter consists of up to five sets of three elements which together identify the model objects. Values for this parameter are described in the following:

*ANY(default) No filtering by model object name. *ALLAll model object owners are included. owner nameName mask of the file to which model objects to be included must belong. That is, the condition is satisfied if a given object is owned by the specified file. *ARRAYSSpecial value for the product internal file *ARRAYS. *MESSAGESSpecial value for the product internal file *MESSAGES. object nameName mask of the object that is satisfied for a given object to be included. *ALL(default) All objects are added. *ACPObjects of type access path. *APPObjects of type application area. *ARRObjects of type array. *CNDObjects of type condition. *FILObjects of type file. *FLDObjects of type field. *FUNObjects of type function. *MSGObjects of type message.

582

Command Reference Guide

YFLTMDLLST (Filter a Model Object List) Command

LSTDATE
The date stored on the model object list entry on which to filter. The value for this parameter is as follows:

*ANY(default) No filtering on list entry date.

Otherwise, LSTDATE is a list parameter made up of the following elements:

Date type on which to filter: *CHG(default) Filter on last change date of object. *CRTFilter on create date of object. *GENFor generatable objects, filter on last successful generation date of object. *CHKFilter on the check out date of object.

date operator: *EQ(default) Equal to. *NENot equal to. *GTGreater than. *LTLess than.

date (Entered in system date format): *QDATE(default) Use current system date.

time (Entered in hhmmss format): *ANY(default) Any time will satisfy the condition.

OBJDATE
The date stored on the model object record on which to filter. The value for this parameter is as follows:

*ANY(default) No filtering on list entry date.

Otherwise, OBJDATE is a list parameter made up of the following elements:

Date type on which to filter: *CHG(default) Filter on last change date of object. *CRTFilter on create date of object. *GENFor generatable objects, filter on last successful generation date of object. *CHKFilter on the check out date of object. *IMPFilter on the import date of the object.

Date operator:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

583

YFLTMDLLST (Filter a Model Object List) Command

*EQ(default) Equal to. *NENot equal to. *GTGreater than. *LTLess than.

Date (Entered in system date format): *QDATE(default) Use current system date.

Time (Entered in hhmmss format): *ANY(default) Any time will satisfy the condition.

CHGUSR
The name of the user who made the change to model objects on which to filter. If used, model objects in the list are filtered according to the current value of the change user field on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on change user. *CURRENTThe name of the current user is used to filter model objects. user nameThe user name on which to filter.

ACTRQD
The model object action required flag on which to filter. If used, model objects in the list are filtered according to the current status of the action required flag on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on action required flag. *NONEModel objects with no action required flag set. *ALLModel objects with action required flag set. *GENModel objects with status *GEN satisfy the condition. *EDTModel objects with status *EDT satisfy the condition.

CUROBJ
The model object current object flag on which to filter. If used, model objects in the list are filtered according to the status of the current object flag on the model object record corresponding with each list entry. Values for this parameter are described in the following:

584

Command Reference Guide

YFLTMDLLST (Filter a Model Object List) Command

*ANY(default) No filtering on current object flag. *YESModel objects with status *YES satisfy the condition. *NOModel objects with status *NO satisfy the condition.

SYSOBJ
Indicates whether or not the object is a system object to be included in the filtering process. Values for this parameter are described in the following:

*ANY(default) No filtering on system object status. *YESOnly system objects satisfy the condition. *NOOnly non-system objects satisfy the condition.

CHGTYP
The change type value assigned to a model object on which to filter. If used, model objects in the list are filtered according to the status of the change type flag on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on change type flag. *PUBLICModel objects with status *PUB satisfy the condition. *PRIVATEModel objects with status *PRV satisfy the condition.

IPCPRC
Impact processed indicator shows whether the impact of a change to the object has been applied to the using objects of the changed object. Values for this parameter are described in the following:

*ANY(default) No filtering on impact processed indicator. *YESModel objects with impact processed *YES will satisfy the condition. *NOModel objects with impact processed *NO will satisfy the condition.

PRMTYP
The promotion type value assigned to a model object list entry on which to filter. Values for this parameter are described in the following:

*ANY(default) No filtering on promotion type flag. *ADDModel object list entries with status *ADD satisfy the condition. *CHGModel object list entries with status *CHG satisfy the condition.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

585

YFLTMDLLST (Filter a Model Object List) Command

*GENModel object list entries with status *GEN satisfy the condition.

VSNTYP
The model object version type flag on which to filter. If used, model objects in the list are filtered according to the current status of the version type flag on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on version type flag. *DEVModel objects with status *DEV satisfy the condition. *PRDModel objects with status *PRD satisfy the condition. *ARCModel objects with status *ARC satisfy the condition.

VSNSNC
The model object version synchronized flag on which to filter. If used, model objects in the list are filtered according to the current status of the version synchronized flag on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on version synchronized flag. *YESModel objects with status *YES satisfy the condition. *NOModel objects with status *NO satisfy the condition.

CHKUSR
The user who checked out the list entry on which to filter. If used, model objects in the list are filtered according to the check out user value on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on check out user. *CURRENTThe current user name is used. user nameThe user name on which to filter.

CHKLST
The list name on which a given list entry is currently checked out. If used, model objects in the list are filtered according to the check out list value on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on check out list.

586

Command Reference Guide

YFLTMDLLST (Filter a Model Object List) Command

*CURRENTThe current user name is used for list name filtering. *NONEOnly those objects that have no value specified for check out list satisfy the condition. list nameThe list name on which to filter.

CHKSTS
The check out status on which to filter. If used, model objects in the list are filtered according to the check out status value on the model object record corresponding with each list entry. Values for this parameter are described in the following:

*ANY(default) No filtering on check out status. status valueThe value on which to filter.

CPYOBJ
The status of the copy object indicator on the list entry. Values for this parameter are described in the following:

*ANY(default) No filtering. *SELECTEDSelected entries satisfy the condition. Selected means explicitly selected for the purposes of the Copy Model Objects command (YCPYMDLOBJ). *NONEEntries that are not selected satisfy the condition.

CPYRQD
The status of the copy required indicator on the list entry. Values for this parameter are described in the following:

*ANY(default) No filtering. *SELECTEDSelected entries satisfy the condition. Selected means implicitly selected for the purposes of the Copy Model Objects command (YCPYMDLOBJ). *NONEEntries that are not selected satisfy the condition.

CPYSTS
The status of the copy status indicator on the list entry. Values for this parameter are described in the following:

*ANY(default) No filtering. *NEWEntries with a value of *NEW satisfy the condition.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

587

YFLTMDLLST (Filter a Model Object List) Command

GENATR
This parameter allows up to five different general attributes of the object to be used in the filtering process. Values for this parameter are described in the following:

*ANY(default) No filtering. *OBJDLTOnly entries that refer to deleted objects satisfy the condition. Note: When filtering for deleted objects it is not possible to add entries for deleted objects to an output list because the corresponding object does not exist. To process these entries, copy the input list to the output list first, then filter *SELECT the deleted objects.

*GENFUNOnly generatable functions satisfy the condition. *GENOBJOnly generatable objects satisfy the condition. *DBFFUNOnly database functions satisfy the condition. *DEVFUNOnly device based functions satisfy the condition. *DSPFUNOnly display functions satisfy the condition. *EDTFUNOnly edit functions satisfy the condition. *EXTFUNOnly external functions satisfy the condition. *INTFUNOnly internal functions satisfy the condition. *PRTFUNOnly print functions satisfy the condition. *CHGOBJOnly change object database functions satisfy the condition. *CRTOBJOnly create object database functions satisfy the condition. *DLTOBJOnly delete object database functions satisfy the condition. *DSPFILOnly display file functions satisfy the condition. *DSPRECOnly display record functions satisfy the condition. *DSPTRNOnly display transaction functions satisfy the condition. *EDTFILOnly edit file functions satisfy the condition. *EDTRCDOnly edit record functions satisfy the condition. *EDTTRNOnly edit transaction functions satisfy the condition. *EXCEXTOnly execute external functions satisfy the condition. *EXCINTOnly execute internal functions satisfy the condition. *PMTRCDOnly prompt record functions satisfy the condition. *PRTFILOnly print file functions satisfy the condition. *PRTOBJOnly print object functions satisfy the condition. *SELRCDOnly select record functions satisfy the condition. *USRPGMOnly user program functions satisfy the condition.

588

Command Reference Guide

YFLTMDLLST (Filter a Model Object List) Command

*USRSRCOnly user source functions satisfy the condition.

OBJATR
This parameter allows model objects to be filtered by up to five different model object attributes. Values for this parameter are described in the following:

*ANY(default) No filtering on object attribute value is performed. object attributeA list of three character object attributes may be entered.

For example, if physical access paths were required, specifying FILTER(*SELECT) OBJATR(PHY) will select any such entries in the input list.

FLAGVAL
This parameter allows model objects to be filtered by the model object list entry flag value. Values for this parameter are described in the following:

*ANY(default) No filtering on flag value is performed. *ERROROnly entries flagged as being in error satisfy the filter. *SELECTEDOnly explicitly selected model objects satisfy the filter.

OUTFLAGVAL
This parameter specifies the initial value to be placed in the object selected flag associated with each list entry. Values for this parameter are described in the following:

*SAME(default) No flag value is used. New entries are written with the flag indicating that the entry is not selected. No change to the selection status of existing entries. *NONENew and existing entries are flagged as not selected. *SELECTEDNew and existing list entries are flagged as selected. This flag can be used by other list commands when selecting list entries.

OUTCPYOBJ
This parameter specifies the initial value to be placed in the copy object flag associated with each list entry. This flag is used by the Copy Model Object command (YCPYMDLOBJ) when selecting objects to copy to a target model. Values for this parameter are described in the following:

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

589

YFLTMDLLST (Filter a Model Object List) Command

*SAME(default) No flag value is used. New entries are written with the flag indicating that the entry is not selected. No change to the selection status of existing entries. *NONENew and existing entries are flagged as not selected. *SELECTEDNew and existing list entries are flagged as selected.

Notes

The input model object list must already exist prior to running this command. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. If *ANY is used for a parameter, that parameter is not used for filtering. The various parameters are ANDed together. Thus, the following request would select all functions from the input list changed today:
YFLTMDLLST OBJNAM( *ALL *ALL *FUN ) + DATE(*CHG *EQ *QDATE *ANY )

Where a list of values may be specified for a parameter the elements are ORed together. Thus, the following would select access paths or functions that have had an action required since they were last generated:
YFLTMDLLST OBJNAM((*ALL *ALL *ACP) (*ALL + *ALL *FUN)) ACTRQD(*ALL)

When *ALLOBJ is specified for MDLLST, meaning that all current model objects are examined, then the OUTLST parameter must specify a target model object list. When filtering on LSTDATE, list entries are filtered according to the value recorded on the list entry. Note that this is historic data relating to the time that the entry was written. Use the Check Model Object list command (YCHKMDLLST) to refresh list entries. The OUTLSTOPT parameter is ignored if *NONE is specified for OUTLST or if the target model object list does not already exist. It should be noted that if an OUTLST is specified, there will be no changes to the input list. Where a name mask is supported, users may specify wild card characters to filter object names. Upper and lower case differences are ignored in these fields. ? may be used as a wild card character in any position in the string and means match on any character. * anywhere within the mask indicates a floating scan. * at the end of the mask indicates a generic name. For example:

590

Command Reference Guide

YINXMDLLST (Index a Model List) Command

*INV001*Would select all objects with INV001 anywhere in the name. *INV001Would select all objects ending with INV001. *INV???Would select all objects ending with INV at the 4th, 5th and 6th positions from the end. INV*UPD*Would select objects starting with INV and containing UPD.

Examples
To filter model object list WRKOBJS to out list WRKLST so that it contains all objects requiring a visit due to updates made to component objects:
YFLTMDLLST ( *EDT ) MDLLST + (*MDLLIB/WRKOBJS ) OUTLST + (*MDLLIB/WRKLST) OUTLSTOPT + ( *REPLACE ) ACTRQD

To filter model object list FUNLST so that it contains only objects relating to Costing (note that a reliable naming convention is required for this type of filtering):
YFLTMDLLST ( '*COST*' ) MDLLST + (*MDLLIB/FUNLST) OBJNAM

To filter model object list ALLOBJLST so that it contains only non-current objects:
YFLTMDLLST FILTER( *OMIT ) ( *YES ) + MDLLST(ALLOBJLST ) CUROBJ

YINXMDLLST (Index a Model List) Command

This command checks for the existence of a model object list and its accompanying logical file members. If the list does not exist, it is created during processing. The command is mainly intended for use internally by Synon/2E, but should be used by developers if an empty list is required for user-defined processing.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

591

YINXMDLLST (Index a Model List) Command

Required
list name *MDLLIB/ YINXMDLLST MDLLST *LIBL/ model library name
*ALL LSTLF YMDLLST00L YMDLLST01L YMDLLST02L YMDLLST03L YMDLLST04L YMDLLST05L YMDLLST06L YMDLLST07L YMDLLST08L YMDLLST09L YMDLLST10L YMDLLST11L max 8
*DFT LSTLF *NONE character string
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YINXMDLLST command.

MDLLST
The qualified model list name that is created, or whose indexes are checked. Values for this parameter are described in the following:

model list name(default) The list name must be entered. *MDLLIB/The library, in which the model list file to be checked exists, is the first model library found in the current job's library. *LIBL/The library list is searched to find the first model library. model library nameThe model library name.

592

Command Reference Guide

YINZWSIPDD command

LSTLF
The name of the logical file that is checked. Values for this parameter are described in the following:

YMDLLST00L(default) The member in file YMDLLST00L is checked for existence. If it does not exist, it is created. YMDLLST01L - 11LProcessed as for YMDLLST00L. *ALLSingle value indicating that all logical files are checked. A new logical file member is added to any file that does not already have one for the specified model list.

TEXT
Up to fifty characters can be entered to describe the list. This is stored as member text for the particular list member specified. Values for this parameter are described in the following:

*DFT(default) A formatted string is used. It contains the model, list and current user id. *NONENo text is specified. character stringThe text can be entered.

Notes
For user-defined processing, it is recommended that when creating a new list, the minimum indexes to be checked using this command is YMDLLST00L. This ensures the integrity of the list, since this member is uniquely keyed on the primary key of the file, the object surrogate number.

Example
To check for the existence of list TSTLST, and to check/create the YMDLLST00L and YMDLLST06L indexes, enter the following command:
YINXMDLLST MDLLST( TSTLST ) LSTLF + ( YMDLLST00L YMDLLST06L ) TEXT( 'Test list.' )

YINZWSIPDD command
The YINZWSIPDD command can be used to reset the Action flag on records in a WSIPDD file. See YEXCWSIPDD for more information.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

593

YOPRMDLLST (Operate on a Model Object List) Command

Parameters
The following are parameters for the YINZWSIPDD command.

WSIPDDLIB
The name of the library in which the target WSIPDD file resides. Values for this parameter are described in the following:

*GENLIBSpecial value representing the model's generation library. nameSpecify the library containing the YWSIPDDRFP file.

ACTION
The value to set the ACTION flag to, for all instances in the WSIPDD file. Value for this parameter is described in the following:

*INSTALLSpecial value representing the Action field should be set to 'I'.

YOPRMDLLST (Operate on a Model Object List) Command

This command allows a user to perform set operations on two input model object lists and to optionally direct the resulting output to a third list. The target list may or may not exist. If it exists, it can be added to or replaced by taking the appropriate option on the LSTOPT parameter.

Required
list name *ALLOBJ *MDLLIB/ YOPRMDLLST MDLLSTA model library/ *USER *SELECT *MDLPRF

594

Command Reference Guide

YOPRMDLLST (Operate on a Model Object List) Command

Optional
*SUB *DIF LSTOPR *INTERSECT *UNION *MDLPRF *ALLOBJ MDLLSTB *USER list name TOMDLLST *USER list name *MDLLSTA *MDLPRF

*REPLACE LSTOPT *ADD

*OBJNAM OPRTYPE *OBJSGT

*YES IGNCRTDTE *NO
CA 2E Modules: *ALL

*YES IGNCHGDTE *NO

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YOPRMDLLST command.

MDLLSTA
The qualified name of the model object list that is the first operand list involved in the operation. Values for this parameter are described in the following:

list name(default) The first model object list name must be entered. *ALLOBJSpecial value meaning that a model object list is not used, but that all model objects are used as input to the command. *MDLPRFSpecial value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The change list value is retrieved. *USERSpecial value meaning that the model object list name is the same as the name of the current user. *SELECTSpecial value meaning that the model object list is selected using an interactive display function. *MDLLIB(default) Special value meaning that the first model library found in the user's current library list is used as the model library for the first list. library nameThe model library name for the first list.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

595

YOPRMDLLST (Operate on a Model Object List) Command

LSTOPR
The operation to be performed on the two lists (sets). See the notes that follow for more details. Values for this parameter are described in the following:

*SUB(default) Subtract the contents of MDLLSTB from MDLLSTA. *DIFFCalculate the difference between the two input lists. *INTERSECTCalculate the intersection of the two input lists. *UNIONCalculate the union of the two input lists.

MDLLSTB
The name of the model object list that is the second operand list involved in the operation. Values for this parameter are described in the following:

*MDLPRF(default) Special value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The change list value is retrieved. *ALLOBJSpecial value meaning that a model object list is not used, but that all model objects are used as input to the command. *USERSpecial value meaning that the model object list name is the same as the name of the current user. list nameThe second model object list name must be entered.

TOMDLLST
The qualified name of the model object list that is the target list involved in the operation. Values for this parameter are described in the following:

*MDLLSTA(default) Single value meaning that the target list of the operation is the first input list. *MDLPRFSpecial value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. The outlist value is retrieved. *USERSpecial value meaning that the model object list name is the same as the name of the current user. list nameThe target model object list name.

LSTOPT
This parameter specifies the action taken if the list already exists in the target model. Values for this parameter are described in the following:

596

Command Reference Guide

YOPRMDLLST (Operate on a Model Object List) Command

*REPLACE(default) The existing model object list is replaced with the output from this command. *ADDThe existing model object list is augmented with the output from this command.

OPRTYPE
Operation method. Values for this parameter are described in the following:

*OBJNAM(default) The list entries are compared by object name. *OBJSGTThe list entries are compared by object surrogate number. This method of comparison may be useful when comparing lists containing objects that have been renamed since the list was created, and the developer does not wish to refresh the list entry prior to the comparison.

IGNCRTDTE
This parameter specifies that create dates on the records are ignored when comparing list entries. This parameter is intended for use when comparing objects from different models. Values for this parameter are described in the following:

*YES(default) Ignore create dates when comparing objects. *NODo not ignore create dates when comparing objects.

IGNCHGDTE
This parameter specifies that change dates on the records are ignored when comparing list entries. Although possible when comparing lists within a particular model, this parameter is most useful when comparing lists of the same objects between different models. Values for this parameter are described in the following:

*YES(default) Ignore change dates when comparing objects. *NODo not ignore change dates when comparing objects.

Notes

The model library specified must be a valid model library. A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution. Both MDLLSTA and MDLLSTB must exist prior to running the command.

Chapter 5: Commands (YDOCMDLACP - YOPRMDLLST)

597

YOPRMDLLST (Operate on a Model Object List) Command

The MDLLSTA and MDLLSTB lists cannot be the same. List operations are as follows: This diagram illustrates the entries of the two intersecting lists:
M D LLST B (Z) (Y) (X)

M D LLSTA

The results of the list operations are: Operand 1 MDLLSTA MDLLSTA MDLLSTA MDLLSTA LSTOPR *UNION *DIFF *INTERSECT *UNION Operand 2 MDLLSTB MDLLSTB MDLLSTB MDLLSTB TOMDLLST Area: X,Y and Z

The LSTOPT parameter is ignored if the target list does not already exist.

Examples
To output a model object list WRKLST to contain all objects from input list INLSTA that are not in input list INLSTB:
YOPRMDLLST MDLLSTA( *MDLLIB/INLSTA ) + LSTOPR( *SUB ) MDLLSTB( INLSTB ) TOMDLLST + ( WRKLST ) LSTOPT( *REPLACE )

To combine two model object lists to the first input list:

YOPRMDLLST MDLLSTA( *MDLLIB/INLSTA ) + LSTOPR( *UNION ) MDLLSTB( INLSTB ) + TOMDLLST ( *MDLLSTA )

To compare list entries between two models to detect whether objects have been changed in one of the models:
YCPYMDLLST FRMMDLLST(YOURMDL/WRKLST)+ TOMDLLST( MYMDL/*USER ) LSTOPT(*REPLACE) YOPRMDLLST MDLLSTA( MYMDL/*USER ) + LSTOPR( *DIFF ) MDLLSTB( *ALLOBJ )+ TOMDLLST( *MDLLSTA ) IGNCHGDTE( *NO )

598

Command Reference Guide

Chapter 6: Commands (YPOPWSIPDD Y2CALL)

This chapter contains details for CA 2E commands YPOPWSIPDD through Y2CALL. These commands appear in alphabetical order and include descriptions of their functions, parameters and allowed values, notes, and examples. Each command is also accompanied by a command diagram.

YPOPWSIPDD (Populate WSIPDD File) Command

Populates a Web Service Instance Portable Deployment Data file (WSIPDD). Once populated, a WSIPDD file can be moved to a remote machine, where the related YEXCWSIPDD (Execute WSIPDD) command can process the file to deploy web service instances on that remote machine. Notes:

Portable deployment does not require CA 2E or 1E to exist on the remote machine. See YEXWSIPDD for details. The YPOPWSIDD command takes a model list as input. The model list is processed and for each function of type Web Service, additional processing occurs (items in the list that are not Web Service functions are ignored). For each Web Service function, all its web service instances are processed. Where a web service instance is not excluded due to filtering arguments on the YPOPWSIPDD command, an instance record will be created in the target WSIPDD file. The target WSIPDD file is always called YWSIPDDRFP, but the location is specified on the WSIPDDLIB parameter. The Target parameters on the YPOPWSIPDD command allow the modeled web service instance data to be overridden when populated to the WSIPDD file.

Parameters
The following are parameters for the YPOPWSIPDD command.

MDLLST
The qualified name of the model object list that is edited. Values for this parameter are described in the following:

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

61

YPOPWSIPDD (Populate WSIPDD File) Command

*MDLPRFSpecial value meaning that the model object list name is retrieved from the user profile extension record for the current user in the specified model library. Create web service instance. *USERSpecial value meaning that the model object list name is the same as the name of the current user. *SELECTSpecial value indicating that the model object list is selected using an interactive display function.

WSIPDDLIB
The name of the library in which the target WSIPDD file resides. Values for this parameter are described in the following: *GENLIB Special value representing the model's generation library nameSpecify the library containing the YWSIPDDRFP/00L files. Note: The WSIPDD file can be created in a target library using the YDUPAPPOBJ command (see the *WS argument for the DUPOPT parameter).

MBROPT
Determines whether output replaces or is appended to any existing data in the WSIPDD file. Values for this parameter are described in the following:

*REPLACEReplace existing member. *ADDAdd to the contents of any existing member.

FMACHINE
Indicates filtering that should be applied to each web service instance to determine if it should be added to the target WSIPDD file. Values for this parameter are described in the following:

*ALLNo filtering is applied, all web service instances, discovered via the input model list, are populated to the WSIPDD file. nameAny web service instance, discovered via the input model object list, whose Server name does NOT match this Filter Server name will NOT be populated to the WSIPDD file.

FSERVICE
Indicates filtering that should be applied to each web service instance to determine if it should be added to the target WSIPDD file. Values for this parameter are described in the following:

62

Command Reference Guide

YPOPWSIPDD (Populate WSIPDD File) Command

*ALLNo filtering is applied, all web service instances, discovered via the input model list, are populated to the WSIPDD file. nameAny web service instance, discovered via the input model object list, whose Service name does NOT match this Filter Service name will NOT be populated to the WSIPDD file.

TMACHINE
Indicates whether modelled web service instance information should be overridden when populated to the target WSIPDD file. Values for this parameter are described in the following:

*INSTANCENo overriding is applied. Modeled web service instance information is used to populate the WSIPDD file. *CURRENTThe modeled web service instance Machine name is overridden to *CURRENT in the WSIPDD target file. nameThe modeled web service instance Machine name is overridden to the named value in the WSIPDD target file.

TSERVER
Indicates whether modelled web service instance information should be overridden when populated to the target WSIPDD file. Values for this parameter are described in the following:

*INSTANCENo overriding is applied. Modelled web service instance information is used to populate the WSIPDD file. character valueThe modelled web service instance Server name is overridden to the named value in the WSIPDD target file.

Note: Server name must match (case sensitive) with the name of the actual application server.

TSERVICE
Indicates whether modelled web service instance information should be overridden when populated to the target WSIPDD file. Values for this parameter are described in the following:

*INSTANCENo overriding is applied. Modelled web service instance information is used to populate the WSIPDD file. nameThe modelled web service instance Service name is overridden to the named value in the WSIPDD target file.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

63

YRDRMDLOBJ (Redirect Model Object) Command

TGTOBJLIB
Indicates whether modelled web service instance information should be overridden when populated to the target WSIPDD file. Values for this parameter are described in the following:

*INSTANCENo overriding is applied. Modelled web service instance information is used to populate the WSIPDD file. nameThe modelled web service instance target object Library name is overridden to the named value in the WSIPDD target file.

TUSRPRF
Indicates whether modelled web service instance information should be overridden when populated to the target WSIPDD file. Values for this parameter are described in the following:

*INSTANCENo overriding is applied. Modelled web service instance information is used to populate the WSIPDD file. nameThe modelled web service instance target user Profile name is overridden to the named value in the WSIPDD target file.

TRTLIBL
Indicates whether modelled web service instance information should be overridden when populated to the target WSIPDD file.

*INSTANCENo overriding is applied. Modelled web service instance information is used to populate the WSIPDD file. nameThe modelled web service instance target runtime library list is overridden to the name value in the WSIPDD target file.

YRDRMDLOBJ (Redirect Model Object) Command

This command provides the means by which the usages of one object can be redirected to another object of the same type. For example, using this command, it is possible to switch from one version of a function to another. Objects can be identified by name or by object surrogate number. At present, only functions or messages can be redirected with this command.

64

Command Reference Guide

YRDRMDLOBJ (Redirect Model Object) Command

Required
*FRMOBJSGT *CURRENT YRDRMDLOBJ FRMOBJNAM owner name *FUN *SELECT *MESSAGES
*FRMOBJNAM FRMOBJSGT model object surrogat
*TOOBJSGT TOOBJNAM *FRMOBJNAM *SELECT *MESSAGES owner name object name *FRMOBJNAM

object name *MSG

*TOOBJNAM TOOBJSGT model object surrogate

*PUBLIC *NO TFRNAM *YES CHGTYP *TOOBJ *NONE

CA 2E Modules: *ALL Job: B,I Pgm: B,I

*PRIVATE

Parameters
The following are parameters for the YRDRMDLOBJ command.

FRMOBJNAM
The name of the object from which usage dependencies in the model are redirected. Values for this parameter are described in the following:

*FRMOBJSGT(default) Single value indicating that the object surrogate number parameter is used to identify the model object. *CURRENTSingle value indicating that the To model object is made current regardless of whichever version in its group is current. object owner name(default) The character name of the object that owns the object. Thus, for a function, the owning file would be entered. *SELECTSpecial value indicating that the object to be redirected from is selected using an interactive display function.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

65

YRDRMDLOBJ (Redirect Model Object) Command

*MESSAGESThe internal file *Messages is the owner of the object (note that this value is only allowed for objects of type *MSG). object nameThe character name of the object. object typeThe object type of the object. *FUNObject is of type function. *MSGObject is of type message. Note that for objects of type *MSG, the owner is the *Messages file.

FRMOBJSGT
Unique number identifier of the model object from which usage dependencies in the model are redirected. Values for this parameter are described in the following:

*FRMOBJNAM(default) Use the object name parameter details to identify this model object. *SELECTSingle value indicating that the object to be redirected to is selected using an interactive display function. object surrogateThe surrogate number of the model object.

TOOBJNAM
The name of the object to which usage dependencies in the model are redirected. Values for this parameter are described in the following:

*TOOBJSGT(default) Single value indicating that the object surrogate number parameter is used to identify the model object. object owner nameThe character name of the object that owns the object. Thus, for a function, the owning file would be entered. *SELECTSpecial value indicating that the object to be redirected from is selected using an interactive display function. *MESSAGESThe internal file *Messages is the owner of the object (note that this value is only allowed for objects of type *MSG). object nameThe character name of the object. object typeThe object type of the object. *FUNObject is of type function. *MSGObject is of type message. Note that for objects of type *MSG the owner is the *Messages file.

66

Command Reference Guide

YRDRMDLOBJ (Redirect Model Object) Command

TOOBJSGT
Unique number identifier of the model object to which model usage dependencies are redirected. Values for this parameter are described in the following:

*TOOBJNAM(default) Use the object name parameter details to identify this model object. object surrogateThe surrogate number of the model object.

TFRNAM
This parameter allows the developer to choose whether or not to transfer the 25-character object name at the same time as redirecting model usages. Values for this parameter are described in the following:

*NO(default) The from object name is not transferred. *YESThe from object name is transferred.

CHGTYP
This field may be used to specify the type of change that the processing programs are to consider the redirection of references to be. Changing this field can cause the component changed flag (COMPCHG) on objects that use this object to be updated also. This will indicate the action required by the user to accommodate the change. Values for this parameter are described in the following:

*PUBLIC(default) The object is considered to have been publicly changed. Appropriate component change processing is performed. *PRIVATEThe object is considered to have been privately changed. Appropriate component change processing is performed. *TOOBJThe change type associated with the to object will be examined by component change processing. *NONEThe redirection of references is not to be considered a change to the object. No component change processing is performed.

Notes

A search is made for the two model objects in the first model library found in the library list.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

67

YRDRMDLOBJ (Redirect Model Object) Command

Redirecting references involves repointing model objects. Since the primary key of model objects is the internal surrogate number, it is this value that is involved in the repointing mechanism. In effect, repointing involves changing the foreign key references of model objects from the source surrogate number to the target surrogate number. Note the following points: Only objects of type FUN and MSG can be repointed. It is not possible to repoint between a MSG and a FUN. Any usages of the source object are switched to use the target object. Archive objects will not be updated during the repointing process. This has repercussions for partial rollback. See the Synon/CM Enhancements section on Rollback procedure for more details. The from object must be the current member of its group. If the target of the command is not a member of the same group, then it must be the current member of its group. If the target of the command is not a member of the same group, then the from object remains current after the transfer, and the implementation name (if there is one) is not transferred. This is necessary to ensure that there is a current member in the from group.

The implementation name of the object is transferred to the new current object. This is the message identifier for MSG type objects and the source member name for generatable FUN type objects. Note that for EXCUSRSRC and EXCUSRPGM there is special processing due to the fact that these types are corrupted by concurrent development unless the previous source member is preserved. The source member name is transferred to the target function. However, if the source member exists, a new source member name is automatically generated to contain a copy of the original source prior to the transfer.

Model objects can either be identified by object name (FRMOBJNAM) or by object surrogate key number (FRMOBJSGT). If the FRMOBJNAM parameter is used, the processing program must convert to surrogate key number internally. Thus, it will normally be more efficient to use the surrogate number if this value is available. The surrogate number for an object can be obtained using the Retrieve Model Object command (YRTVMDLOBJ). Note that if TFRNAM (*YES) is specified, the object names are swapped between the two objects. Developers should take note of this change and also that model object lists are not automatically updated to reflect this change to the objects referred to by the entries. Use the Check Model Object List command (YCHKMDLLST) to refresh model object list entries.

68

Command Reference Guide

YRGZMDL (Reorganize Model) Command

Example
To redirect model object dependencies from Edit Owner to Edit Owner (new ver) enter the following command:
YRDRMDLOBJ FRMOBJNAM + ( 'Owner' 'Edit Owner' *FUN ) TOOBJNAM + (*FRMOBJNAM 'Edit Owner (new ver)' + *FRMOBJNAM )

YRGZMDL (Reorganize Model) Command

Reorganizes a model or job list to recover space used by deleted records. This command should be run regularly for both a model and a job list for the purposes of housekeeping.

Required
library name YRGZMDL MDLLIB *CURLIB *MDL RGZOPT *JOBLST
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YRGZMDL command.

MDLLIB
Name of library containing a design model or job list that is reorganized. The value for this parameter is as follows:

*CURLIBUse current library for invoking job.

RGZOPT
Option to reorganize model or job list contained in library specified by MDLLIB parameter. Values for this parameter are described in the following:

*MDL(default) Reorganize model. *JOBLSTReorganize job list.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

69

YRNMMDL (Rename Model) Command

Notes
The model or job list cannot be used while it is being reorganized.

Example
To reorganize model MYMDL:
YRGZMDL MDLLIB(MYMDL)

YRNMMDL (Rename Model) Command

Renames a model library. Updates model values and library lists.

Required
*CURLIB YRNMMDL MDLLIB library name NEWMDLLIB library name *SAME

610

Command Reference Guide

YRNMMDL (Rename Model) Command

Optional
*GENLIB *SAME GENLIB *CURLIB library name *GUIFLR GUIFLR folder name NEWGUILIB library name *SAME NEWGENLIB library name

*LIBL/ LIBLST library name/ *NONE *LIBL/ NEWLIBLST library name/ *SAME

*MDLLIB library list name *NEWMDLLIB library list name

*NEWLIBLST/ *ALL *LIBL/ library list name UPDLIBLST library name/ *SAME
*CRTJBD *NONE JOBD *CURLIB job description name
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YRNMMDL command.

MDLLIB
Name of library to contain the design model that is renamed. Must be a model library. The value for this parameter is as follows:

*CURLIB(default) Current library invokes job.

NEWMDLLIB
New name for the model library. The value for this parameter is as follows:

*SAME(default) Do not rename model library.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

611

YRNMMDL (Rename Model) Command

GENLIB
Name of generation library to be renamed. Values for this parameter are described in the following:

*GENLIB(default) Name is specified by the YGENLIB model value of the model named by the MDLLIB parameter. *CURLIBCurrent library invokes job.

NEWGENLIB
New name for generation library. The value for this parameter is as follows:

*SAME(default) Do not rename the generation library.

GUIFLR'
Name of the shared folder used by Synon/TC to transfer information to the PC that is to be renamed. Values for this parameter are described in the following:

*GUIFLR(default) Name is specified by the YGUIFLR model value of the model named by the MDLLIB parameter. folder nameValid shared folder name.

NEWGUIFLR
New name for the shared folder used by Synon/TC to transfer information to the PC. Values for this parameter are described in the following:

*SAME(default) Do not rename the Synon/TC shared folder. folder nameValid shared folder name.

LIBLST
Qualified name of a library list that is renamed. Values for this parameter are described in the following:

*MDLLIB(default) Library list has the same name as the model library. *NONEDo not rename the library list.

NEWLIBLST
New name for library list. Values for this parameter are described in the following:

612

Command Reference Guide

YRNMMDL (Rename Model) Command

*NEWMDLLIB(default) Rename library list to have same name as that specified by the NEWMDLLIB parameter. *SAMEDo not rename library list.

UPDLIBLST
Qualified name of library lists that are updated to reflect the new names of the model and/or generation libraries. Values for this parameter are described in the following:

*NEWLIBLST/*ALL(default) All library lists in the library list file of the library specified by the NEWLIBLST parameter are updated. *NONEDo not update any library lists.

JOBD
Job description name in the library given by the MDLLIB parameter whose initial library list is updated. Values for this parameter are described in the following:

*CRTJBD(default) Name is specified by YCRTJBD model value of model named by MDLLIB parameter. *NONEDo not update job description. *CURLIBCurrent library.

Notes

You cannot rename a model or a generation library while they are in use. Prior to running the command, all journals and journal receivers must be removed from each library to be renamed. If specifying a LIBL to be updated, the LIBL must exist at the start of running the command. If the only LIBL the user wants to update is the one that gets renamed from LIBLST to NEWLIBLST, the user should enter LIBLIST name for UPDLIBLST. The command does the following: If NEWMDLLIB is not *SAME, renames the model library, and changes the YMDLLIB model value to the value specified by NEWMDLLIB parameter. If NEWGENLIB is not *SAME, renames the generation library, and changes the YGENLIB model value to the value specified by NEWGENLIB parameter. If NEWLIBLST is not *SAME, and LIBLST is not *NONE, renames the library list to the value specified by NEWLIBLST parameter.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

613

YRTVMDLOBJ (Retrieve Object Description) Command

Updates library lists specified by the UPDLIBLST parameter for the renamed libraries. If JOBD is not *NONE, changes the initial library list of the named job description to the value specified by NEWLIBLST parameter.

If you have an SQL collection, be aware that YRNMMDL will not rename the SQL collection.

Example
To rename library MYMDL to YOURMDL, and library MYGEN to YOURGEN, and library list MYMDL to YOURMDL, updating the initial library list of the appropriate job description:
YRNMMDL MDLLIB(MYMDL) NEWMDLLIB + (YOURMDL) GENLIB(MYGEN) + NEWGENLIB(YOURGEN)

YRTVMDLOBJ (Retrieve Object Description) Command

This command provides access to general and certain user-definable object data that is supported in the data model for most model object types. It is intended that these data be used to support a user-defined change control facility operating upon model objects.

Required
*OBJSGT YRTVMDLOBJ OBJNAM *NONE *ARRAYS object name *MESSAGES owner name *ARR *CND *FIL *FLD *FUN *MSG
*OBJNAM OBJSGT object surrogate
*MDLLIB MDLLIB model library name

*ACP *APP

614

Command Reference Guide

YRTVMDLOBJ (Retrieve Object Description) Command

Optional
RTNOWNNAM RTNOBJTYP RTNOBJSGT CRTDTE CHGDTE CHGUSR IPCPRC COMPDTE CUROBJ VSNTYP ARCSEQ VSNSNC IMPTME CHKTME CHKLST
IMPNAM

CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name
CL variable name

RTNOBJNAM RTNOWNSGT OBJATR CRTTME CHGTME CHGTYP GENDTE COMPTME PRMTYP GRPSGT ARCSGT IMPDTE CHKDTE CHKUSR CHKSTS
SEUTYP

CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name
CL variable name

CA 2E Modules: *ALL

Pgm: B,I

Parameters
The following are parameters for the YRTVMDLOBJ command.

OBJNAM
The object name of the object whose details are retrieved. This parameter consists of three elements that together identify a model object. Values for this parameter are described in the following:

*OBJSGT(default) Single value indicating that the object surrogate is used to identify the model object. object owner nameThe character name of the object that owns the object. Thus, for a function, the owning file would be entered. object nameThe character name of the object. object typeThe object type of the object. *ACPObject is of type access path. *APPObject is of type application area. *ARRObject is of type array. *CNDObject is of type condition.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

615

YRTVMDLOBJ (Retrieve Object Description) Command

*FILObject is of type file. *FLDObject is of type field. *FUNObject is of type function. *MSGObject is of type message.

OBJSGT
Unique number identifier of the model object whose details are retrieved. Values for this parameter are described in the following:

*OBJNAM(default) Use object name to identify the model object. object surrogateThe surrogate number of the model object.

MDLLIB
This parameter specifies the data model that is edited. Values for this parameter are described in the following:

*MDLLIB(default) The model to be edited is the first one found in the current job's library list. model nameThe model library name.

RTNOWNNAM
CL variable that receives the name of the owner of the object. If the object has no owner, then *NONE is returned. Character variable, twenty-five bytes long.

RTNOBJNAM
CL variable that receives the name of the object. Character variable, twentyfive bytes long.

RTNOBJTYP
CL variable that receives the object type of the object. Character variable, three bytes long.

TNOWNSGT
CL variable that receives the surrogate key of the owner of the object. Decimal variable, seven digits packed.

616

Command Reference Guide

YRTVMDLOBJ (Retrieve Object Description) Command

RTNOBJSGT
CL variable that receives the surrogate key of the object. Decimal variable, seven digits packed.

OBJATR
CL variable that receives the object attribute of the object. Character variable, three bytes long.

CRTDTE
CL variable that receives the value of the creation date of the object. Character variable, eight bytes long.

CRTTME
CL variable that receives the value of the creation time of the object. Character variable, six bytes long.

CHGDTE
CL variable that receives the value of the last change date of the object. Character variable, eight bytes long.

CHGTME
CL variable that receives the value of the last change time of the object. Character variable, six bytes long.

CHGUSR
CL variable that receives the name of the user who last changed the object. Character variable, ten bytes long.

CHGTYP
CL variable that receives the current value of the change type that has occurs for the object. Character variable, eight bytes long. Values for this parameter are described in the following:

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

617

YRTVMDLOBJ (Retrieve Object Description) Command

blankNo changes have occurred to this object since it was last updated for non-generatable objects or last generated for generatable objects. *PRIVATEA private change has been made to the object, such as a change to the panel design of an interactive function type. *PUBLICA public change has been made to the object, such as a change to the parameters of a function. *GENA change has been made to the object requiring generation/compilation of the implementation objects only, such as a change to the source member text. *OBJA change has been made to the object which affects no other objects and does not require regeneration of any source.

IPCPRC
CL variable that receives the component change processed value for the object. Character variable, four bytes long. Values for this parameter are described in the following:

*YESComponent change processing has been performed for the object. *NOComponent change processing has not been performed for the object.

GENDTE
CL variable that receives the value of the last successful generation date of the object. Character variable, eight bytes long.

ENTME
CL variable that receives the value of the last successful generation time of the object. Character variable, six bytes long.

ACTRQD
CL variable that receives the current value of the component change indicator for the object. Character variable, four bytes long. Values for this parameter are described in the following:

blankNo components of this object have been changed since it was last edited for non-generatable objects or last generated for generatable objects.

618

Command Reference Guide

YRTVMDLOBJ (Retrieve Object Description) Command

*EDTA component of the object has been changed requiring that the object be revisited and edited to resolve the changes. If this is a generatable object, it must also be regenerated. *GENA component of the object has changed requiring that this generatable object be regenerated.

OMPDTE
CL variable that receives the last date that the object or one of its components was changed. Character variable, eight bytes long.

COMPTME
CL variable that receives the last time that the object or one of its components was changed. Character variable, six bytes long.

CUROBJ
CL variable that receives the current value of the current object indicator for the object. Character variable, four bytes long. Values for this parameter are described in the following:

*YESThis is a current object, which means that it is visible on model panels and can be used extensively throughout the data model. *NOThis is not a current object. This means that it is not visible on normal model panels. It is visible on model object lists and on the Display Versions panel. This does not necessarily mean that the object is not used.

PRMTYP
CL variable that receives the current value of the promotion type that occurs for the object. Character variable, four bytes long. Values for this parameter are described in the following:

blankNo promotion type set. *ADDThe object is added to a target environment. *CHGThe object replaces an existing version of itself in the target environment. *GENThe object is generated from the target environment. The design object is not promoted.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

619

YRTVMDLOBJ (Retrieve Object Description) Command

SNTYP
CL variable that receives the current value of the version type indicator for the object. Character variable, four bytes long. Values for this parameter are described in the following:

blankThe object is not part of a group. *PRDThis is a production object. There can only be one member of a group with this status. *DEVThis is a development version of the object. *ARCThis is an archive version of the object.

RPSGT
CL variable that receives the current value of the group object surrogate key number. This value will be zero if the object does not currently belong to a group. Numeric variable, seven bytes long.

ARCSEQ
CL variable that receives the current value of the archive sequence number of the object. This value is only set for archive versions.

ARCSGT
CL variable that receives the current value of the archive surrogate number. This value is only set for production versions that have an archive version in existence.

VSNSNC
CL variable that receives the current value of the version synchronized indicator for the object. This field is intended for use as part of a change control system. Character variable, four bytes long. Values for this parameter are described in the following:

*YESThe object is synchronized. *NOThe object is not synchronized.

620

Command Reference Guide

YRTVMDLOBJ (Retrieve Object Description) Command

MPDTE
CL variable that receives the last import date for the object. This value is set by the import program when the object is created in the model as part of an import process from another model or another product. Thus, for example, this date might represent the date the object was created in the model as part of processing by the Copy Model Object command (YCPYMDLOBJ). Character variable, eight bytes long.

IMPTME
CL variable that receives the last import time for the object. This value is set by the import program when the object is created in the model as part of an import process from another model or another product. Thus, for example, this time might represent the time the object was created in the model as part of processing by the Copy Model Object command (YCPYMDLOBJ). Character variable, six bytes long.

CHKDTE
CL variable that receives the value of the checkout date of the object. Character variable, eight bytes long.

CHKTME
CL variable that receives the value of the checkout time of the object. Character variable, six bytes long.

CHKUSR
CL variable that receives the name of the user who last checked out the object. Character variable, ten bytes long.

CHKLST
CL variable that receives the name of the list on which the object checked out. Character variable, ten bytes long.

CHKSTS
CL variable that receives the checkout status of the object. Character variable, seven bytes long.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

621

YRTVMDLOBJ (Retrieve Object Description) Command

IMPNAM
CL variable that receives the implementation name of the object. Character variable, ten bytes long. Values for this parameter are described in the following:

ACPsource member name APPapplication area code ARRblank CNDblank FILgeneration prefix FLDDDS name FUNsource member name, or blank (internal functions) MSGmessage identifier

SEUTYP
CL variable that receives the system SEU type of the object. This value is blank for non-source based objects. Character variable, ten bytes long.

ASSOJ
CL variable that identifies model objects associated with assimilated objects. Character variable, four bytes long. Values for this parameter are described in the following:

*YFILAny file that is flagged as assimilated. *YACPPhysical access path that is based on an assimilated file. *YFUNExecute User Program (EXCUSRPGM) or Execute User Source (EXCUSRSRC) functions.

Notes
Object data can be retrieved using either the object name or the object surrogate identifier. Whichever method is used, all return variables contain the appropriate data.

Example
To find out the date and time that the Customer file was last changed, and who made that change:

622

Command Reference Guide

YRTVMDLPRF (Retrieve Model Profile details) Command

YRTVMDLOBJ OBJNAM( *NONE 'Customer' + *FIL ) CHGDTE( &CHGDTE ) CHGTME + ( &CHGTME ) CHGUSR( &CHGUSR )

This information could then be used for comparison with the same object (by name) in another data model.

YRTVMDLPRF (Retrieve Model Profile details) Command

Certain data is stored in each data model associated with the user profiles of developers. This command allows these values to be retrieved in command language programs.

Required
YRTVMDLPRF MDLPRF model user profile name

Optional
SSNLST COMPCHG USROPT USROPTMBR NPDFIL ADESRVMODE JOBLST GENLIB JOBD CRTJOBD SBMGENOPT
SRNMODE
CA 2E Modules: *ALL

CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name CL variable name
CL variable name

LOGCHG VIEWONLY USROPTLIB MDLLST NPDFUN

CL variable name CL variable name CL variable name CL variable name CL variable name

JOBLSTLIB SRCLIB JOBDLIB CRTJOBDLIB SBMCRTOPT

GUIFLR

CL variable name CL variable name CL variable name CL variable name CL variable name
CL variable name
Pgm: B,I

Parameters
The following are parameters for the YRTVMDLPRF command.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

623

YRTVMDLPRF (Retrieve Model Profile details) Command

MDLPRF
The name of the model user profile that is retrieved. The value for this parameter is as follows:

user profile nameThe name of the user profile must be entered.

SSNLST
CL variable that receives the name of the session list for the specified user. Character variable, ten bytes long.

LOGCHG
CL variable that receives the log changed objects indicator. Character variable, four bytes long.

COMPCHG
CL variable that receives the perform component changed processing indicator. Character variable, four bytes long.

MDLLST
CL variable that receives the name of the model object list that is retrieved when *MDLPRF is specified on list and other commands. Character variable, ten bytes long.

VIEWONLY
CL variable that receives the view only indicator. Character variable, four bytes long.

USROPT
CL variable that receives the name of the user options file. Character variable, ten bytes long.

USROPTLIB
CL variable that receives the name of the user options file library. Character variable, ten bytes long.

624

Command Reference Guide

YRTVMDLPRF (Retrieve Model Profile details) Command

USROPTMBR
CL variable that receives the name of the user options file member. Character variable, ten bytes long.

MDLLST
CL variable that receives the name of the model object list that is retrieved when *MDLPRF is specified on list and other commands. Character variable, ten bytes long.

NPDFIL
CL variable that receives the name of notepad function owning file. Character variable, twenty-five bytes long.

NPDFUN
CL variable that receives the name of notepad function. Character variable, twenty-five bytes long

ADESRNMODE
CL variable that receives the default value for the action diagram full screen mode. Character variable, four bytes long.

JOBLST
CL variable that receives the name of the job list to be defaulted in the Submit Model Creates command (YSBMMDLCRT). Character variable, ten bytes long.

JOBLSTLIB
CL variable that receives the name of the job list library to be defaulted in the Submit Model Creates command (YSBMMDLCRT). Character variable, ten bytes long.

GENLIB
CL variable that receives the name of the generation library to be defaulted in the Submit Model Creates command (YSBMMDLCRT). Character variable, ten bytes long.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

625

YRTVMDLPRF (Retrieve Model Profile details) Command

SRCLIB
CL variable that receives the name of the library where source is placed. Character variable, ten bytes long.

JOBD
CL variable that receives the name of the job description to be defaulted in the Submit Model Creates command (YSBMMDLCRT). Character variable, ten bytes long.

JOBDLIB
CL variable that receives the name of the job description library to be defaulted in the Submit Model Creates command (YSBMMDLCRT). Character variable, ten bytes long.

CRTJOBD
CL variable that receives the name of the create job description library to be defaulted in the Submit Model Creates command (YSBMMDLCRT). Character variable, ten bytes long.

CRTJOBDLIB
CL variable that receives the name of the create job description library to be defaulted in the Submit Model Creates command (YSBMMDLCRT). Character variable, ten bytes long.

SBMGENOPT
CL variable that receives the default value for the submit generation option parameter on the Submit Model Creates command (YSBMMDLCRT). Character variable, four bytes long.

SBMCRTOPT
CL variable that receives the default value for the submit compilation option parameter on the Submit Model Creates command (YSBMMDLCRT). Character variable, six bytes long.

626

Command Reference Guide

YRTVMDLVAL (Retrieve Model Value) Command

SRNMODE
CL variable that receives the default value for full screen mode. It is used by the Edit Model List command (YEDTMDLLST). Character variable, one byte long.

GUIFLR
CL variable that receives the default value for the GUI folder parameter on the Submit Model Creates command (YSBMMDLCRT). Character variable, sixtythree bytes long.

Notes
The model profile name must exist prior to running this command.

Example
To retrieve the model update details for user GEORGE:
YRTVMDLPRF MDLPRF( GEORGE ) CHGLST + ( &CHGLST ) LOGCHG( &LOGCHG ) COMPCHG + ( &COMPCHG )

YRTVMDLVAL (Retrieve Model Value) Command

Retrieves a model value.

Required
YRTVMDLVAL MDLVAL (1) model value name VALUE CL var

(1) One of the allowed values.

CA 2E Modules: *ALL Pgm: B,I

Parameters
The following are parameters for the YRTVMDLVAL command.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

627

YRTVPFMDL (Retrieve Physical Files Into Model) Command

MDLVAL
Name of model value that is retrieved. One of the model values. See the YCHGMDLVAL (Change Model Value) command in this chapter for further details about the allowed model values.

VALUE
CL variable to receive model value. (80 characters.)

Notes

See the YCHGMDLVAL command section in this chapter for further information about the role of the various model values. This command can only be executed within a CL program.

Example
To retrieve the YGENLIB model value:
DCL VAR(&VALUE) TYPE(*CHAR) LEN(80) DCL VAR (&GENLIB) TYPE(*CHAR) LEN(10) YRTVMDLVAL MDLVAL(YGENLIB) + VALUE(&VALUE) CHGVAR &GENLIB &VALUE

YRTVPFMDL (Retrieve Physical Files Into Model) Command

Retrieves file descriptions of compiled database physical files into a design model. All developers and programmers should be out of the model before you execute this command. For more information on the YRTVPFMDL command, see the Assimilation chapter in the Defining a Data Model guide.

628

Command Reference Guide

YRTVPFMDL (Retrieve Physical Files Into Model) Command

Required
*ALL/ *LIBL/ YRTVPFMDL FILE *CURLIB/ *ALLUSR/ library name/ *USRLIBL/ generic* file name file name

Optional
*YES RMVFLDPFX *NO
CA 2E Modules: *ALL

*NONE REFILE file name

Job: B,I Pgm: B,I

Parameters
The following are parameters for the YRTVPFMDL command.

FILE
Qualified generic name of physical files whose descriptions are retrieved into the model. The value for this parameter is as follows:

*ALLRetrieve all files.

RMVFLDPFX
Specifies whether any action is taken to remove a prefix from the DDS field names of the fields in the retrieved physical files. Values for this parameter are described in the following:

*YES(default) The first two characters of each field name are considered to be a prefix that is dropped from the name. For example, field name XXCUCD will be translated to XX+CUCD. *NODo not remove the first two characters from the field names.

REFFILE
Name of file to treat as the field reference file. No file or Has relations are created for this file but all fields are added to the data dictionary. File should be among the list of files specified by the FILE parameter. The value for this parameter is as follows:

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

629

YRTVPFMDL (Retrieve Physical Files Into Model) Command

*NONE(default) No file is treated as a field reference file.

Notes
The YRTVPFMDL command retrieves into a model all file and field definitions not already present in the model. For each named database file, the command proceeds in the following manner.

The i OS command Display File Field Description (DSPFFD) is used to obtain the object's file, format and field definitions. The existing model is examined to determine if a file already exists in the model with a source member name that is the same as the i OS object name of the file. (The source member names for files are specified with the Edit Access Path Details display: the name is held on the PHY (Physical) access path). If an access path of type PHY with the same member name already exists in the model, the retrieved file is ignored. If one does not exist, then a new file is added to the model as follows:

The text (if any) of the database file is used as the name: for example, Customer file. If another file already exists with the text, then a number is appended to the text of the new file name to make it unique. For example, Customer file 01265. If the file has no text then the i OS object name is used as the Synon/2E name. The new file has a file type of REF. An access path of type Physical (PHY) is defined. The source member name held for the access path is the i OS object name of the retrieved file. The Assimilated file flag on the file details is set to yes. A Defined as relation is created for the file.

For each field in the database file definition or column in the table definition, the YRTVPFMDL command proceeds in the following manner: The existing model is examined to determine if a field already exists in the model with a DDS name that is the same as that of the retrieved field. The comparison is done as follows:

If RMVFLDPFX(*YES) was specified, the field prefix is dropped from the retrieved DDS field name for purposes of comparison. For example, JJCUCD is compared with CUCD. The field names, against which the retrieved field name is compared, are the values (i.e., those shown on the Edit Field Details and the Display Field References displays). If RMVFLDPFX(*NO) was specified, the full DDS name of the retrieved field is used for the comparison. For example, JJCUCD is compared with JJCUCD. The field names against which the retrieved field name is compared are not the values, but rather old field names.

630

Command Reference Guide

YRTVPFMDL (Retrieve Physical Files Into Model) Command

If the name matches, a further comparison is made between the length and i OS data type (packed, zoned, or alphanumeric) of the retrieved field and the existing model fields. If a field of the correct name and type exists in the model, no new field is added. If one does not exist, then a new field is added to the model as follows: The text of the retrieved field is used as the name: for instance, Customer code. If another field already exists with the text, then a number is appended to the text of the new name to make it unique. For example, Customer code 012654. If the retrieved field has no text, then the retrieved DDS name is used as the Synon/2E name. The new field is given a data type according to the i OS data type of the retrieved field as follows: i OS Type A A A P P S S Length in Bytes 1 2 - 10 11 or more Any: integer Any: real Any: integer Any: real CA 2E Type STS CDE TXT NBR VAL NBR VAL

If RMVFLDPFX(*YES) was specified, the truncated field name is stored as the field name. For example, JJCUCD is stored as CUCD. If RMVFLDPFX(*NO) was specified, Synon/2E allocates a new name as the DDS field name. For example, CUSNUM might be stored as ZQNB. A Has relation is added to connect every field with the file, unless the file is a field reference file, as specified by the REFFILE parameter.

A physical file format entry is created. This is used to store: The old field name used in the particular i OS physical file. The sequence of the field within the retrieved PF record. The i OS data type and length of the old field.

This information can be used by Synon/2E to regenerate source for an i OS physical file that exactly matches the retrieved version. You can use the Edit Physical File Format entries display to examine and change the physical file format entries.

Amending the retrieved file.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

631

YRTVPFMDL (Retrieve Physical Files Into Model) Command

Having retrieved a database file into a model, you will need to add extra information to specify the key relations and to establish the file-to-file relations among the various files that you have retrieved. This should be done as follows: Change the field attributes of code fields that are the keys of files to be CDE. (Select Z2 to invoke the Edit Field Details display for the key fields, and use F8 to change the attributes). Alter the relation type of the relations that connect Synon/2E files with their own key fields from Has to Known by or Qualified by. (Type over the existing relation using the Edit Database Relations display). Alter the relation type of files containing fields that are the keys to other files from Has to Refers to, or Owned by, and change the referenced field of such relations to be the appropriate referenced Synon/2E file. (Type over the existing relation using Edit Database Relations display. Also delete superfluous relations using the D option).

You should also amend the field details in order to specify additional data types and to add field conditions: Change the field attributes of non-key fields to be the appropriate type (for example, TXT, STS). (Select Z2 to invoke the Edit Field Details display for the non-key fields, and use F8 to change the attributes). Use the Edit Condition Details display to add conditions. Use the Edit Field Details display to change the field attributes to specify a check condition.

The removing of field prefixes that takes place if RMVFLDPFX(*YES) is specified is done by a CL program, YRTVPHYR1C, the source of which is supplied. You may modify this program if you wish. An example would be if you need to retrieve file descriptions from systems where a convention of appending a prefix to the end of field names, rather than the beginning, has been used. The use of the reference file parameter is not related to the Synon field reference files specified by the model value YFRFVNM.

Example
To retrieve all the physical file descriptions of files whose names begin with C and reside in library QGPL, removing field prefixes from the DDS fields:
YRTVPFMDL FILE(QGPL/C*)

For example, if you have three files to retrieve:

632

Command Reference Guide

YRTVPFMDL (Retrieve Physical Files Into Model) Command

Company

CMPDTAP

XCOCD XXCONM

Company code Company name Company code Customer code Customer name Credit limit Customer type cd Customer type cd Customer type nm P

4 50 4 4 50 7.2 1

Customer

CUSDTAP

PPCOCD PPCUCD PCUNM PPCULM PPCUCD

Customer type

CUSTYPP

QQCUCD QQCUNM

1 50

They will be retrieved as follows:

FIL FIL

Company Company

REF REF

Has Has

FLD FLD

Company code Company name

CDE TXT

FIL FIL FIL FIL FIL

Customer Customer Customer Customer Customer

REF REF REF REF REF

Has Has Has Has Has

FLD FLD FLD FLD FLD

Company code Customer code Customer name Credit limit Customer type cd

CDE CDE TXT NBR STS

FIL FIL

Customer type Customer type

REF REF

Has Has

FLD FLD

Customer type cd Customer type nm

STS TXT

You will probably want to change them to the following set of statements:

FIL FIL

Company Company

REF REF

Known by Has

FLD FLD

Company code Company name

CDE TXT

FIL FIL FIL FIL FIL

Customer Customer Customer Customer Customer

REF REF REF REF REF

Owned by Known by Has Has Refers to

FIL FLD FLD FLD FIL

Company Customer code Customer name Credit limit Customer type

REF CDE TXT VAL REF

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

633

YSBMMDLCRT (Submit Create Requests from Model) Command

FIL FIL

Customer type Customer type

REF REF

Known by Has

FLD FLD

Customer type Customer type nm

CDE TXT

Note: For more information about this example, see the YRTVPFMDL command in this guide.

YSBMMDLCRT (Submit Create Requests from Model) Command

Generates and compiles the source members named in a CA 2E job list.

634

Command Reference Guide

YSBMMDLCRT (Submit Create Requests from Model) Command

Optional

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

635

YSBMMDLCRT (Submit Create Requests from Model) Command

*MDLPRF *MDLPRF/ *USER *MDLLIB/ YSBMMDLCRT JOBLST *CURLIB/ *WRKSTN library name/ list name
*MDLPRF *NO EDIT *YES (2) GENLIB *CURLIB library name *GENLIB

*SELECT(1)

*MDLPRF *OBJLIB SRCLIB *GENLIB *CURLIB library name

*MDLPRF/ *MDLLIB/ JOBD *LIBL/ *CURLIB library name

*CURRENT *JOBD JOBPTY priority *USRPRF CURLIB *CRTDFT

*MDLPRF *MDLVAL job description

*JOBD INLLIBL *CURRENT

*WRKSTN *NONE MSGQ *USRPRF *LIBL message queue name library name/

*JOBD *NONE CRTJOBD *MDLPRF/ *LIBL/ *MDLLIB/ library name/

*CRTJOBD CRTJOBD priority *HLD *MDLPRF *MDLPRF *GUIFLR SBMCRTOPT *GENOK *IMMED folder name GUIFLR *MDLVAL SBMGENOPT *RLS

*MDLPRF job description name

*MDLPRF

636

Command Reference Guide

YSBMMDLCRT (Submit Create Requests from Model) Command

*CHANGE *USE AUT *EXCLUDE *ALL REPLACE *YES *NO

*FRFVNM FLDREF *NONE field ref file name CPYLIB

*NONE *CPYLIB library name

*NONE OLDLIB *OLDLIB library name

(1) *SELECT and (2) EDIT are valid only in an interactive environment.
CA 2E Modules: *ALL Pgm: B,I

Parameters
The following are parameters for the YSBMMDLCRT command.

JOBLST
Qualified name of a job list generated by CA 2E. Values for this parameter are described in the following:

*MDLPRF(default) The value is retrieved from the model profile details associated with the current user. *MDLLIB/*USERDefault job list name to user profile name, and store list in model library. *WRKSTNDefault the job list name to job name of invoking job. *SELECTDisplay a list of existing lists, one of which may be selected.

EDIT
Edit list option. Values for this parameter are described in the following:

*NO(default) Do not invoke list edit function. *YESInvoke the list edit function before proceeding with compilations.

GENLIB
Library in which to place compiled objects. Values for this parameter are described in the following:

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

637

YSBMMDLCRT (Submit Create Requests from Model) Command

*MDLPRFThe value is retrieved from the model profile details associated with the current user. *GENLIBRetrieve the name of the generation library from the model value (YGENLIB). *CURLIBUse the current library for invoking the job.

SRCLIB
This parameter specifies the library into which source is generated or which contains the source for a create object request. Values for this parameter are described in the following:

*MDLPRF(default) The value is retrieved from the model profile details associated with the current user. *OBJLIBThe library to use is the same one as that specified for the GENLIB parameter. *GENLIBRetrieve the name of the generation library from the model value (YGENLIB). *CURLIBUse current library for invoking job. library nameThe library name for source.

JOBD
Qualified name of job description used when submitting job to carry out source generation. Values for this parameter are described in the following:

*MDLPRF(default) The value is retrieved from the model profile details associated with the current user. *MDLVALRetrieve the name of the job description from the CA 2E model value (YCRTJBD).

JOBPTY
Job scheduling priority; 1 (high) to 9 (low). The value for this parameter is as follows:

*JOBD(default) Use priority on job description.

CURLIB
This parameter specifies the current library for the submitted job. Values for this parameter are described in the following:

*CURRENT(default) The current value for the current library is used.

638

Command Reference Guide

YSBMMDLCRT (Submit Create Requests from Model) Command

*CRTDFTNo current library is specified. *USRPRFThe current library for the user profile is used. library nameThe current library name.

INLLIBL
Initial library list for submitted jobs. Values for this parameter are described in the following:

*JOBDUse library list of job description specified by JOBD parameter. *CURRENTUse library list of current job.

MSGQ
Qualified name of a message queue to which completion messages from submitted jobs are sent. Values for this parameter are described in the following:

WRKSTN(default) Send messages to the workstation message queue. USRPRFSend messages to the user's default message queue. *NONENo messages are sent.

CRTJOBD
Qualified name of job description used for compilations. Values for this parameter are described in the following:

*JOBD(default) Use the job description specified by the JOBD parameter. *NONENo compilations are submitted and no objects are deleted.

CRTJOBPTY
Job scheduling priority for compilations; 1 (high) to 9 (low). The value for this parameter is as follows:

*CRTJOBD(default) Use priority on job description specified by CRTJOBD parameter.

SBMGENOPT
Option to specify whether or not the job containing the functions to be generated should be released after being submitted. Values for this parameter are described in the following:

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

639

YSBMMDLCRT (Submit Create Requests from Model) Command

*MDLPRF(default) The value is retrieved from the model profile details associated with the current user. *RLSRelease the job containing functions to be generated immediately. *HLDLeave the job containing the functions to be generated as HELD on the job queue.

SBMCRTOPT
Option to specify when compilations should be submitted. Values for this parameter are described in the following:

*MDLPRF(default) The value is retrieved from the model profile details associated with the current user. *GENOKCompilations of source members in the job list are submitted only after the source has been successfully generated. *IMMEDCompilations of source members are submitted immediately; that is, by the job which submits the job to generate the source.

GUIFLR
Name of folder to contain GUI implementation objects created from source generated by CA 2E. Values for this parameter are described in the following:

*MDLPRF(default) The value is retrieved from the model profile details associated with the current user. *GUIFLRThe name of the folder is retrieved from the model value (YGUIFLR). *MDLVALThe name of the folder is retrieved from the model value (YGUIFLR). folder nameThe folder name can be entered.

AUT
Authorization rights to be granted for compiled objects. Values for this parameter are described in the following:

*CHANGE(default) Grant operational rights and all data rights. *USEGrant operational rights and read data rights. *EXCLUDEDo not grant access rights. *ALLGrant all rights.

640

Command Reference Guide

YSBMMDLCRT (Submit Create Requests from Model) Command

REPLACE
Option to use the REPLACE option on the appropriate i OS CRTxxxPGM command (only applies to programs). Only applies if you are creating IBM i native objects; that is, if the model value YCRTENV of your model is QCMD. Values for this parameter are described in the following:

*NO(default) Do not use the REPLACE option on the CRTxxxPGM command being used to create the program. If the program already exists, CA 2E deletes it before the compilation is submitted. Hence if the compilation fails, no version of the program will exist. *YESSpecify REPLACE(*YES) on the i OS CRTxxxPGM command being used to create the program. If the program already exists, CA 2E will not delete it until the new version has been successfully compiled. If the compilation is not successful, the old version of the program will still exist.

FLDREF
Name of field reference file member. If a member of the specified name is found in the member list, it is compiled before all other source members. Values for this parameter are described in the following:

*FRFVNMRetrieve the name of the field reference file from the model value (YFRFVNM). *NONENo field reference file member is compiled.

CPYLIB
Name of library from which to copy data to add to new versions of existing physical files. Values for this parameter are described in the following:

*NONE(default) Data is not copied for existing files. *CPYLIBRetrieve the name of the data library from the model value (YCPYLIB).

OLDLIB
Library into which previous versions of physical files are placed. When a new version of an i OS object is created, the old version from the nominated GENLIB is placed in the given OLDLIB. Any previous old version is deleted. Values for this parameter are described in the following:

*NONE(default) Old versions of the physical files are not saved. *OLDLIBRetrieve the name of the data library from the model value (YOLDLIB).

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

641

YSBMMDLCRT (Submit Create Requests from Model) Command

Notes
The Job List
The job list must already exist. It can be created either from within a model, or by using the Build Job List (YBLDJOBLST) command. A single job will be submitted to carry out any source generation. Each compilation of a source member will normally be submitted as a separate job. You can specify whether the job is to be submitted immediately, or after the generation has completed successfully. For each source member named in a job list, the YSBMMDLCRT command can invoke up to three different processing steps:

Generation of source Compilation of source into an object For physical files only, back copying of data from an existing version of the file into the newly compiled file

Generation of source
A single job will be submitted to carry out source generation. The job will be released by default SBMGENOPT(*RLS) unless SBMGENOPT(*HLD) is specified. If you have specified that a field dictionary be used; that is, the YFRFVNM model value is other than *NONE, source for the field reference file will be regenerated before the compilation list is shown.

Compilation of Source Into an Object

Source members will be processed in the correct order for compilation:

Field reference physical file Physical files Logical files Display files Programs

Each compilation will be submitted as a separate job. The compilations can be submitted in two ways:

642

Command Reference Guide

YSBMMDLCRT (Submit Create Requests from Model) Command

SBMCRTOPT(*GENOK)The job which generates the source will submit the jobs to compile the generated objects, provided the generation is successful. The submitting of the compilations is thus a batch process. SBMCRTOPT(*IMMED)The job which submits the source generation will also submit the compilations. Thus, the submitting of compilations will usually be interactive. Compilations for objects requiring source generation will be submitted as held jobs. If an error occurs when generating a source member, the corresponding compilation job will be canceled by the source generation job. If a compilation is canceled, this is recorded as an error on the job list.

Completion messages are returned to the message queue specified by the MSGQ parameter. All the elements of a function or an access path (QRY access paths only) must be generated successfully before compilation is attempted. Thus, if any part fails to generate, no part will be submitted for compilation if SBMCRTOPT (*GENOK), or the compilations for all parts will be canceled if SBMCRTOPT(*IMMED). If CRTJOBD(*NONE) is specified, no objects will be deleted, and no compilations will be submitted.

Back copying of data

Physical files that are recompiled will be archived if a value is specified for the OLDLIB parameter. Data is copied into physical files that have been recompiled if a value is specified for the CPYLIB parameter. If CPYLIB is the same as OLDLIB, the YSBMMDLCRT command copies the original data back into the physical files as far as possible. When CRTJOBD(*NONE) is specified, no data will be copied and no files will be archived.

Example
To generate and compile all the source members in your job list and to then submit the compilations after the generation is complete:
YSBMMDLCRT

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

643

YSETCPYNME (Set Model Object Copy Name) Command

YSETCPYNME (Set Model Object Copy Name) Command

This command examines objects in the CA 2E data model and, depending on whether the object is versionable, either checks or resets the Copy name in the object's model object description. The Copy name field stored on the Model Object file is used by the Copy Model Objects (YCPYMDLOBJ) command to determine object matches between the source and target models. You can use the Copy name field to force YCPYMDLOBJ to match Object A in the source model with Object B in the target model. The YSETCPYNME command allows all objects in the model to be reset back so that an object's Copy name is equal to its Object name. A report documents changes made by the program for non-versionable objects and lists warnings for versionable objects. You must have *DSNR authority to use this command.

Notes

For versionable objects (functions and messages), the Copy name of all members of the group of versions must be the same. This is because all versions in the group should match with the same object in a target model, otherwise, the concept of versions does not exist. A copy of any one of the versions in the group using YCPYMDLOBJ should match with the same object in the target model. The Copy name of each versionable object is validated against all other versions in that object's group. If it differs from any of the other versions a report notifies you that the group is not set up correctly. To recover, you must adjust the Copy name of one of the versions with the Change Model Object Description (YCHGMDLOD) command, which updates all versions in the group to have the same Copy name.

For non-versionable objects, such as access paths, fields, and conditions the program compares the Copy name with the Object name of the object. If they differ, the Copy name is set to be equal to the Object name and the update action is reported.

Example
To check and/or change the copy names associated with model objects contained in model library HSTMDL:
YSETCPYNME MDLLIB( HSTMDL )

Deleted GENFLR, OS2NODE, WINFLR, UNXDIR, UNXNDE

644

Command Reference Guide

YSLTVSN (Select Version) Command

YSLTVSN (Select Version) Command

This command provides an interactive panel for the selection of a version from a group of versions.

Required
YSLTVSN OBJSGT object surrogate

Optional
*MDLLIB MDLLIB model library
RTNVAL
CA 2E Modules: *ALL

CL variable name
Pgm: B,I

Parameters
The following are parameters for the YSLTVSN command.

OBJSGT
The object surrogate number of the object from whose group the version is to be selected. This is a required parameter.

MDLLIB
The model library name in which the object, identified by the object surrogate parameter, exists. Values for this parameter are described in the following:

*MDLLIB(default) The model library is the first such library found in the library list. model libraryThe name of the model library to use.

RTNVAL
The CL variable that receives the object surrogate number of the selected model object version. The value for this parameter is as follows:

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

645

YSNCMDL (Synchronize Model) Command

CL variable nameNumeric variable, seven bytes long.

Example
To select a version from the group to which the object identified by object surrogate number 1102597 belongs:
YSLTVSN OBJSGT( 1102597 )

This command provides a return parameter containing the object surrogate number identifier of the selected version. It must, therefore, be called from an interactive CL program.

YSNCMDL (Synchronize Model) Command

This command allows the user to synchronize a model outside of the model environment.

Required
*MDLLIB YSNCMDL *CURLIB model name
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YSNCMDL command.

MDLLIB
The name of the model to be synchronized. Values for this parameter are described in the following:

*MDLLIB(default) Special value indicating the model library in the current library list. *CURLIB(default) Special value indicating the current library of the job. model nameThe name of the model to be synchronized.

646

Command Reference Guide

YSTRCHGCTL (Start Change Control) Command

Notes
Each CA 2E file in the model specified is expanded and the model synchronization flag is set.

Example
To synchronize the model Y2PGMR enter the following:
YSNCMDL MDLLIB(Y2PGMR)

YSTRCHGCTL (Start Change Control) Command

This command sets up Synon/CM for the model library in the current job's library list. If there is an existing change control system in place, it is possible to access those details during processing so that the initial starting position for a particular model object can be determined. Administrators are advised to examine the options of this command and to plan its use carefully as it may be important to establish the starting position of model objects correctly.

Required
*MDLLIB YSTRCHGCTL model library name
*CM CHGCTLLIB AllFusion 2E CM library name

*DEV *PRD SETVSNTYP *BYLOCK *ASSOC

*NO RMVLCK *YES (1) PRDMDLLIB

name of production model

(1) PRDMDLLIB is prompted when SETVSNTYP is set to *ASSOC.

CA 2E Modules: *ALL Job: B,I Pgm: B,I

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

647

YSTRCHGCTL (Start Change Control) Command

Parameters
The following are parameters for the YSTRCHGCTL command.

MDLLIB
The name of the model library in which change control is to be started. Values for this parameter are described in the following:

*MDDLIB(default) Use the first model library in the job's current library list. model libraryThe name of the model library to use.

CHGCTLLIB
This parameter specifies the name of the Synon/CM product library installed on your machine. Values for this parameter are described in the following:

*CM(default) Use default name (Y2SYCM). Synon/CM libraryName of Synon/CM library.

SETVSNTYP
This parameter specifies the starting version type for model objects. Values for this parameter are described in the following:

*DEV(default) All model objects are initialized to a version type of DEV. This indicates that the model is a development model. *PRDAll model objects are initialized to a version type of PRD. This indicates that the model is a production model. *BYLOCKNormally models will consist of a combination of development and production objects. A common way of differentiating between these two types is to place a permanent lock on production objects inside the model (lock type *PERM). This parameter value will examine the lock status of each object. If a permanent lock exists for an object, the version type for that object is set to *PRD, otherwise it is set to *DEV. *ASSOCUse this value to invoke the Associate Production Model (YASCPRDMDL) command. You will be prompted to enter the name of the target production model library. See the PRDMDLLIB parameter below.

RMVLCK
This parameter specifies the action to take for locks within the model. Values for this parameter are described in the following:

648

Command Reference Guide

YSTRCHGCTL (Start Change Control) Command

*NO(default) Model locks are not deleted. *YESAs part of processing, if a permanent lock is detected for an object, it is deleted.

PRDMDLLIB
The name of the production model that is to be used for comparing model objects using the Associate Production Model (YASCPRDMDL) command. See the command diagram or the online Help for more details relating to this command. This parameter is prompted only if *ASSOC is specified for the Set Version Type parameter (SETVSNTYP). The value for this parameter is as follows:

model library nameThe name of the model library. You must specify this name explicitly.

Notes
Regardless of the value specified for the SETVSNTYP parameter, you can set the version type in an exit program called YSTRCHGR1C. The interface for this program is as follows, and the source is shipped in QCLSRC in library Y2SYSRC:
Parameters : Object surrogate : 7 decimal 3 character 3 character

Derived version type : Return version type :

The derived version type is arrived at during processing dependent upon the value specified for SETVSNTYP. However, if a valid value is returned by the exit program, it will be used in preference. Developers may take this opportunity to examine details of the object, identified by its surrogate number key (in an external database, for example). The CA 2E Change Management product is required to run with Change Management. See your CA 2E Change Management documentation for more information.

Example
To start change control in model library J4DEVMDL, setting all objects to *DEV and removing any permanent locks:

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

649

YSTRY2 (Start CA 2E) Command

YSTRCHGCTL SETVSNTYP(*DEV) RMVLCK(*YES )

YSTRY2 (Start CA 2E) Command

Sets library list for CA 2E and displays the CA 2E menus.

Optional
*libl/ *Y2MDL/ *SELECT - (*S) *CURLIB/ library list name YSTRY2 library name/ *SAME *SAME
MAIN MENU DSNR PRMR USER *SELECT *Y1 - *Y) menu name *y2 *s
CA 2E Modules: *ALL Job: I Pgm: I

Parameters
The following are parameters for the YSTRY2 command.

LIBLST
Name of library list used to replace the current job's library list before displaying the help menus. When you create a model using the command Create Model Library (YCRTMDLLIB), an appropriate library list to allow you to use the model is created automatically. By default it will have the same name as the model. The library list is stored using the CA 2E Toolkit library list facilities. Values for this parameter are described in the following:

*Y2MDL(default) CA 2E model library list name. *SELECTDisplay library lists in the specified library, one of which may be selected.

650

Command Reference Guide

YWRKDSTFIL (Work Distributed Files) Command

*SAMEDo not change the current library list.

MENU
Name of first menu you want to display. Values for this parameter are described in the following:

MAIN(default) Display master menu. DSNRDisplay menu for designers. PGMRDisplay menu for programmers. USERDisplay menu for users. *SELECTDisplay a list of help menus, one of which may be selected. *Y1Display CA 2E Toolkit master menu.

Notes
The library list of the job is replaced with the specified list. Additional library lists can be created using the Synon/1E command Build Library List (YBLDLIBLST). Existing library lists can be altered using the Synon/1E command Edit Library List (YEDTLIBLST).

Example
To enter CA 2E and edit model MYMDL:
YSTRY2 LIBLST(MYMDL)

YWRKDSTFIL (Work Distributed Files) Command

Allows the user to specify for each distributed file the names of databases to which it applies plus the default sequence of databases by which to access it. This command invokes the distributed file configuration table editor which allows users to tailor the configuration of RDBs for tables and views. This RDB configuration information is used by distributed applications generated from the model. This application is shipped in the null model and must be generated by the users.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

651

YWRKDSTFIL (Work Distributed Files) Command

Optional
TABLE YWRKDSTFIL VIEW *ALL
CA 2E Modules: *ALL Job: B,I Pgm: B,I

Parameters
The following are parameters for the YWRKDSTFIL command.

FILTYP
Type of access path that is subsetted on the Work With Distributed Files panel. Values for this parameter are described in the following:

TABLE(default) Subset to show only tables. VIEWSubset to show only views. *ALLDo not subset. Show all tables and views.

Notes
The YWRKDSTFIL command invokes the program Y2DSTFR (Work With Distributed Files) which in turn will invoke Y2CFGTR (Work With Configuration Table Entries), when option 5 is selected. These programs allow a user to tailor the RDBs for tables and views that will be accessed by distributed applications. The command and the associated programs are application objects that form part of the objects created when the command YDUPAPPOBJ is run. For more information about YDUPAPPOBJ, refer to the Duplicate Application Objects (YDUPAPPOBJ) command.

Example
To work with distributed files, subsetting to show only tables:
YWRKDSTFIL FILTYP (TABLE)

652

Command Reference Guide

YWRKMDLLST (Work with Model Object Lists) Command

YWRKMDLLST (Work with Model Object Lists) Command

This command provides access to an interactive panel displaying all model object lists that exist in the specified model. The work with panel provides a number of options to manipulate a model object list. For more information on the available options, please refer to the help text for the panel.

Required
*MDLLIB YWRKMDLLST MDLLIB model library name

*DSNR USER *PGMR *USER

CA 2E Modules: *ALL Job: I Pgm: B,I

Parameters
The following are parameters for the YWRKMDLLST command.

MDLLIB
The name of the model library in which the lists reside. Values for this parameter are described in the following:

*MDLLIB(default) The model library to use is the first library in the current job's library list. model library nameThe name of the model.

USER
Type of user. Must be one of the following: Values for this parameter are described in the following:

*DSNR(default) A designer may change any aspect of the model, including the database. *PGMRA programmer can add or change any functions that are in the model, but may not alter the relations, files or database fields.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

653

Y2 (Edit Model) Command

*USERA user may view all aspects of the model but may not change any design objects. This class of user is useful to allow the data model to be examined without the possibility of change.

Notes
A value other than *MDLLIB for MDLLST may result in the library list being changed. If the user is currently editing a model, the switching of the library list will not occur and the command will fail. If changed during processing, the library list is changed back after execution.

Example
To work with model object lists in model library ATSTMDL, enter the following command:
YWRKMDLLST MDLLIB(ATSTMDL)

Y2 (Edit Model) Command

Calls an interactive program to enter and edit the first CA 2E model in your library list. Y2 is the short form of YEDTMDL.

654

Command Reference Guide

Y2 (Edit Model) Command

Optional
*DSNR *MDLLIB Y2 USER *PGMR *USER
*MDLLIB/ *DLPRF *GENLIB/ *USER *SRCLIB/ JOBLST *LIBL/ *SELECT *CURLIB/ job list name library name/
*EDTDBREL *EDTMDLLST ENTRY *NONE *SERVICES SSNLST *SELECT model list name *MDLPRF *USER

MDLLIB model library name

*WORKSTN

*MDLPRF *USER *MDLVAL OPNACC *NO *SELECT model list name

CA 2E Modules: *ALL Job: I Pgm: I

MDLLST

*ALLOBJ

Parameters
The following are parameters for the Y2 command.

USER
Type of user. Values for this parameter are described in the following:

*DSNR(default) A designer can change any aspect of the model, including the database. *PGMRA programmer can add or change any functions that are in the model, but cannot alter the relations, files or fields. *USERA user can view all aspects of the model but cannot change any design objects. This class of user is useful to allow the data model to be examined without the possibility of change.

MDLLIB
This parameter specifies the data model that is edited. Values for this parameter are described in the following:

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

655

Y2 (Edit Model) Command

*MDLLIB(default) The model to be edited is the first one found in the current job's library list. model nameThe model library name.

JOBLST
Qualified name of job list that contains the names of source members to be generated and/or compiled. If the nominated job list does not already exist, it will be created. Values for this parameter are described in the following:

*MDLPRF(default) Retrieve the job list name from the model profile details of the current user. *USERThe job list name is the same name as the current user. *WORKSTNUse device name of current workstation as list name. *SELECTDisplay a list of existing job lists, one of which may be selected. job list nameThe name of the job list can be entered. *MDLLIB/The job list library is the first model library found in the library list. *GENLIB/Use the generation library specified in the first model found in the library list. *SRCLIB/Use the source library specified on the model profile of the current user. *LIBL/The job list library is the first model found in the library list *CURLIB/The model library is found in the current library for the current job. job list libraryThe job list library can be entered.

ENTRY
This parameter provides the user with multiple entry points to the specified model. Values for this parameter are described in the following:

*EDTDBREL(default) The first panel to be accessed is the Edit Database Relations panel. *EDTMDLLSTThe mode of entry to the model is via the Edit Model List panel. If this value is specified, the MDLLST parameter specifies the model list that is edited. *SERVICESThe services menu is the first panel to be accessed.

656

Command Reference Guide

Y2 (Edit Model) Command

*NONEThis option can be used to establish a model environment but without any particular entry to the model. In this case the model environment is started and the developer is presented with the Command Entry panel. Numerous commands require the model environment to be active and will check to ensure that it is active when invoked. These commands will adopt an already active environment. Thus, if a series of commands are run, it will be more efficient to use this option before executing such commands. Another advantage of this option is that the lock applied to the model is established for the entire session, preventing interference by another developer.

SSNLST
This parameter specifies the session list to use while editing the model. For more information:on the purpose of SSNLST, refer to the Change Model Profile command (YCHGMDLPRF). Values for this parameter are described in the following:

*MDLPRF(default) The session list is retrieved from the model profile details for the current user. *USERThe session list has the same name as the current user. *SELECTAn interactive display is used to select a model object list to be used as the session list. model list nameThe name of the list can be entered.

OPNACC
This parameter enables the current user to override to *NO (if authorized) the Open Access model value. The intention with this parameter is to provide a *DSNR with the opportunity to gain exclusive access to the data model. For more information:on Open Access, see the Change Model Value command (YCHGMDLVAL) in this chapter and the Creating and Managing Your Model chapter in the CA 2E Administrator Guide. Values for this parameter are described in the following:

*MDLVAL(default) Access to the model is controlled by the current model value for Open Access. *NOThis value can be used to set the Open Access model value to exclude any concurrent *DSNR activity in the model and to exclude users of any other class.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

657

Y2 (Edit Model) Command

MDLLST
The qualified name of the model object list that is edited. Values for this parameter are described in the following:

*USERThe list to be edited has the same name as the current user. *ALLOBJThe all objects list is edited. *SELECTSpecial value indicating that the model object list is selected using an interactive display function.

Notes

The model can either be set up to allow concurrent *DSNRs and *PGMRs/*USERs into the model by setting the model value YOPNACC to *YES, or the model value can be left as *NO where either a single *DNSR or multiple *PGMRs/*USERs can be in the model concurrently. To add and remove permanent locks, or to change the Open Access (YOPNACC), you must have all rights to the data model. (Designer with locks capability). To edit a model as a user of type *DSNR, you must have at least all rights except for existence to the model. Generally the most convenient way to arrange this is to grant all rights to all the objects in the model library (the default), and then to control access to the model by granting or revoking rights to use the data area YMDLLIBRFA in the model library. The YEDTMDL command checks the user's authority to this data area before allowing entry to the model. For example, to revoke all rights to user profile IVAN to edit or view a model MYMDL:
RVKOBJAUT OBJ(MYMDL/YMDLLIBRFA) + OBJTYPE(*DTAARA) USER (IVAN) AUT(*ALL)

Or to grant user profile IVAN rights to an edit model MYMDL as designer with lock capability:
GRTOBJAUT OBJ(MYMDL/YMDLLIBRFA) + OBJTYPE(*DTAARA) USER(IVAN) AUT(*ALL)

To override the model value YOPNACC (represented in the command by OPNACC) by specifying *NO, you must have all rights to the data area YOPNACCRFA. Access rights to YOPNACCRFA can be assigned or revoked in the same way as above. Should you wish to change the YOPNACC value temporarily just for the duration of the session, you must synchronize the model on exit.

Examples
To edit a model as a designer:

658

Command Reference Guide

Y2CALL (Call a Program) Command

YEDTMDL

To edit a model as a programmer, using a list named after the current device name:
YEDTMDL USER(*PGMR) JOBLST(*WORKSTN)

Y2CALL (Call a Program) Command

This command determines the parameters required by a model function from details contained in the data model. Each field, comprising a parameter or part of a parameter structure, is processed and optionally presented to the user for preloading of parameter values. The purpose of this command is to allow developers to test low level functions requiring numerous parameters without the need to code layers of intervening programs which construct those parameters. Values can be supplied for all input capable fields and can be reused for subsequent invocations.

Required
Y2CALL PGM program name

Optional
QTEMP *NO DTALIB *GENLIB library name CLEAR *YES

*YES EDIT *NO *NO STRCMTCTL *YES *NO COMMIT *YES

CA 2E Modules: *ALL

*YES OUTPAR *NO *CHG LCKLVL *ALL

Job: B,I Pgm: B,I

Parameters
The following are parameters for the Y2CALL command.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

659

Y2CALL (Call a Program) Command

PGM
The name of the program to be called. This is the same as the source member name of the function in the data model.

DTALIB
The library name in which parameter values are stored. Values for this parameter are described in the following:

QTEMP(default) Use temporary library QTEMP to store parameter values. *GENLIBThe generation library is used to store parameter values. library nameAnother library name can be entered.

CLEAR
Indicates whether the parameter values are cleared before editing or the call to the program. Values for this parameter are described in the following:

*NO(default) Existing values for parameters are not cleared. *YESParameter values are cleared.

EDIT
Indicates whether the developer wishes to edit the parameters prior to the call. Values for this parameter are described in the following:

*YES(default) Parameter entries are edited. *NOParameters are not edited prior to the call.

OUTPAR
Specifies whether output parameters defined in the called program, should be retrieved when it terminates. The values from the output parameters will be displayed on the edit screen. Values for this parameter are described in the following:

660

Command Reference Guide

Y2CALL (Call a Program) Command

*YES(default) Output parameters are retrieved when the called program terminates. Note: If output parameters are retrieved, the called program will be placed in debug. This is because the retrieval of the parameters is done using debug functions.

*NOOutput parameters are not retrieved. Note: Output parameters cannot be retrieved for EXCUSRPGMs or action bars. They also cannot be retrieved if EDIT is *NO.

STRCMTCTL
This parameter specifies whether commitment control is started before the call. This may be necessary for a function that normally would operate as a *SLAVE. Values for this parameter are described in the following:

*NO(default) Commitment control is not started. *YESCommitment control is started prior to the call.

COMMIT
Indicates whether a commit is executed following the call. This parameter is only shown if *YES is specified for the STRCMTCTL parameter. Values for this parameter are described in the following:

*NO(default) A commit is not issued. *YESA commit is issued following the call.

LCKLVL
The level of locking to be applied when performing I/O. This parameter is only shown if *YES is specified for the STRCMTCTL parameter. Values for this parameter are described in the following:

*CHG(default) Only changed records are locked. *ALLAll records read on update access paths are locked.

Notes

If the program name exists in the model, the parameters defined for the function are displayed if EDIT(*YES) is specified. The program object must exist prior to the call. If parameter values are not defined prior to the call, character parameters will default to blanks and numeric parameters to zero.

Chapter 6: Commands (YPOPWSIPDD - Y2CALL)

661

Y2CALL (Call a Program) Command

If commitment control is started as part of the processing, it is also ended before the command processing programs return. Users should ensure that parameter details are defined correctly in the model. This is especially true of Execute User Program functions (EXCUSRPGM), particularly when they are the first program from a menu option, when it is not necessary to define parameters in the model at all.

Example
To call the model function Prc Allocate Stock Item, clearing any existing parameter values and to edit the parameters:
Y2CALL PGM(UUAKEXR) CLEAR(*YES) EDIT(*YES)

662

Command Reference Guide

Appendix A: Commands Grouped by Functional Area

The following shows CA 2E commands grouped by functional area.

Upgrade Commands

YAPYMDLCHGApply Model Changes YAPYSYSMDLApply Model System Objects Changes

Model Setup Commands

YAPYTRNMDLApply Translation to Model YCHGMDLPRFChange Model Profile details YCHGMDLVALChange Model Values YCLRMDLClear a Model YCRTMDLLIBCreate Model Library YCRTSQLLIBCreate SQL Library YCVTMDLVNMConvert Model Names YDSPMDLVALDisplay Model Value YEDTDFTATREdit Default Display Attributes YEXCSQLExecute SQL Statements YRGZMDLReorganize a Model YRNMMDLRename a Model YRTVMDLPRFRetrieve Model Profile details YRTVMDLVALRetrieves a Model Value YRTVPFMDLRetrieve Physical Files into Model YSNCMDLSynchronize Model YSTRCHGCTLStart Change Control

Appendix A: Commands Grouped by Functional Area

A1

Model Objects Commands

Model Objects Commands

YCHGMDLOBJChange Model Object YCHGMDLODChange Model Object Description YCHKMDLOBJCheck existence of Model Object YCMPMDLOBJCompare Model Objects YCRTMDLVSNCreate Model Version YCRTOBJVSNCreate Model Version YDLTMDLVSNDelete Model Version YDSPMDLODDisplay Model Object Description YRDRMDLOBJRedirect Model Object YSLTVSNSelect Model Object Version YRTVMDLOBJRetrieve Object Description

Edit Commands

YEDTMDLEnter/Edit a Model YEDTMDLLSTEdit Model Object List YEDTMDLPRFEdit Model Profile YSTRY2Start CA 2E Y2Edit Model

Create Application Commands

YBLDJOBLSTBuild Job List YCHKJOBLECheck Job List Entries YCRTGENOBJCreate Generation Objects YCRTJOBLECreate Job List Entry YCVTCNDVALConvert Condition Values YCVTJOBLSTConvert Job List to CA 2E Toolkit Object List YCVTMDLLSTConvert a Model Object List to a Job List

A2

Command Reference Guide

Model Object Lists Commands

YCVTMDLMSGConvert Model Messages YDSPJOBLSTDisplay a Job List YDUPAPPOBJDuplicate Application Objects YSBMMDLCRTSubmit Create Objects from Model

Model Object Lists Commands

YADDMDLLEAdd a Model Object List Entry YBLDMDLLSTBuild a Model Object List YCHGMDLLEChange a Model Object List Entry YCHKMDLLSTCheck a Model Object List YCLRMDLLSTClear a Model Object List YDLTMDLLEDelete a Model Object List Entry YDLTMDLLSTDelete a Model Object List YDSPMDLLSTDisplay a Model Object List YEXCMDLLSTExecute a Model Object List YFLTMDLLSTFilter a Model Object List YINXMDLLSTIndex a Model List YOPRMDLLSTOperate on a Model Object List YWRKMDLLSTWork with Model Object Lists

Document Commands

YDOCMDLACPDocument Model Access Paths YDOCMDLAPPDocument Model Application Areas YDOCMDLFDocument Model Files YDOCMDLFLDDocument Model Fields YDOCMDLFUNDocument Model Functions YDOCMDLLSTDocument a Model Object List YDOCMDLMSGDocument Model Messages YDOCMDLRELDocument Model Relations YDOCURFDocument Unreferenced Objects

Appendix A: Commands Grouped by Functional Area

A3

Copy Commands

Copy Commands

YCPYMDLCopy a Model YCPYMDLLSTCopy Model Object List YCPYMDLOBJCopy Model Objects YEDTCPYLSTEdit a Model Object List for Copy

Miscellaneous Commands

YAPYCMPCHGApply Component Changes YCHKMDLCheck Model YCHKDTAMDLCheck Data Model YCHKFUNACTCheck Function Action Diagram YCVTDSTFILConvert Distributed Files YCVTMDLPNLConvert Model Panels to Prototypes YCVTTMUIMConvert Help Text to UIM YDSPMDLREFDisplay Model References YDSPMDLUSGDisplay Model Usages YEDTNXTMNCEdit Next Autoname Type Mnemonic YSETCPYNMESet Model Object Copy Name YWRKDSTFILWork Distributed Files Y2CALLCall a Program

A4

Command Reference Guide

Index
*
*DSNR User Type YEDTMDL command, 5-59 *PGMR User Type YEDTMDL command, 5-59 *USER User Type YEDTMDL command, 5-59 CA 2E Models reorganizing, 6-7 CA 2E shipped source YDUPAPPOBJ command, 5-55 CA 2E Toolkit Utility Library YCRTMDLLIB command, 4-47 CALC action diagram user point, 3-48 Call a Program (Y2CALL), 6-56 Change a Model Object List Entry (YCHGMDLLE), 3-21 change control YCHGCTL model value, 3-57 Change Model Object (YCHGMDLOBJ), 3-23 Change Model Object Description (YCHGMDLOD), 3-29 Change Model Profile (YCHGMDLPRF), 3-32 Change Model Value (YCHGMDLVAL), 3-41 change control, 3-57 YCRTMDLLIB command, 4-45 Check a Model Object List (YCHKMDLLST), 375 Check Data Model (YCHKDTAMDL), 3-65 Check Existence of Model Object (YCHKMDLOBJ), 3-82 Check Function Action Diagram (YCHKFUNACT), 3-66 Check Job List Entries (YCHKJOBLE), 3-68 Check Model (YCHKMDL), 3-71 Clear a Model Object List (YCLRMDLLST), 4-2 Clear Model (YCLRMDL), 4-1 COBOL generation field names, 4-41 specifying model value, 4-41 COBOL names

A
access paths documenting, 5-1 Add a Model Object List Entry (YADDMDLLE), 3-1 Apply Component Changes (YAPYCMPCHG), 35 Apply Model Changes (YAPYMDLCHG), 3-6 Apply System Model Data (YAPYSYSMDL), 3-8 Apply Translation to Model (YAPYTRNMDL), 3-9

B
Build a Model Object List (YBLDMSLLST), 3-16 Build Job List (YBLDJOBLST), 3-11 Build Library List (YBLDLIBLST) Synon/1E, 6-48

C
CA 2E entering, 6-47 required model data level, 3-8 required model release level, 3-9

Index1

YCVTMDLVNM command, 4-71 company name, 4-39 Compare Model Objects (YCMPMDLOBJ), 4-4 component change processing, 3-5 impact analysis, 3-5 condition values converting, 4-54 Convert a Job List to CA 2E Toolkit Object List, (YCVTJOBLST), 4-58 Convert Condition Values (YCVTCNDVAL), 4-54 Convert Distributed Files (YCVTDSTFIL), 4-56 Convert Help Text to UIM Panel (YCVTTMUIM), 4-71 Convert Model Messages (YCVTMDLMSG), 4-65 Convert Model Names (YCVTMDLVNM), 4-70 Convert Model Object List to Job List (YCVTMDLLST), 4-61 Convert Model Panel Designs (YCVTMDLPNL), 4-66 copy library (YCPYLIB) YSBMMDLCRT command, 6-38 Copy Model (YCPYMDL), 4-9 Copy Model Object List (YCPYMDLLST), 4-11 Copy Model Objects (YCPYMDLOBJ), 4-14 copy name changing, 4-23, 6-41 how assigned, 4-23 copying objects, 4-22 Create Generation Objects (YCRTGENOBJ), 430 Create Job List Entry (YCRTJOBLE), 4-33 Create Model Library (YCRTMDLLIB), 4-35 model values, 3-41 YSTRY2 command, 6-47 Create Model Version (YCRTMDLVSN), 4-47 Create Object Version (YCRTOBJVSN), 4-51 Create SQL Library (YCRTSQLLIB), 4-52

CRTDTAARA i OS command, 4-44 CRTDUPOBJ i OS command, 4-44 CRTJOBD i OS command, 4-44 CRTLIB i OS command, 4-44 CRTPF i OS command, 4-44 CRTSRCPF i OS command, 4-44 CUATEXT, 3-46

D
data model integrity of, 3-65, 3-71 DDS Field names copying objects, 4-27 prefixes, 6-29 default HLL (YSYSHLL) YCRTMDLLIB command, 4-41 Delete a Model Object List (YDLTMDLLST), 476 Delete a Model Object List Entry (YDLTMDLLE), 4-74 Delete a Model Version (YDLTMDLVSN), 4-77 dependencies between model objects YDSPMDLREF command, 5-30 YDSPMDLUSG command, 5-41 Display a Job List (YDSPJOBLST), 5-23 Display a Model Object List (YDSPMDLLST), 525 display attributes defaults, 5-57 Display Model Object Description (YDSPMDLOD), 5-27 Display Model References (YDSPMDLREF), 5-30 Display Model Usages (YDSPMDLUSG), 5-41 impact analysis, 5-52 Display Model Value (YDSPMDLVAL), 5-52 Document a Model Object List (YDOCMDLLST), 5-15

Index2

Command Reference Guide

Document Model Access Paths (YDOCMDLACP), 5-1 Document Model Application Areas (YDOCMDLAPP), 5-3 Document Model Fields (YDOCMDLFLD), 5-7 Document Model Files (YDOCMDLF), 5-5 Document Model Functions (YDOCMDLFUN), 58 Document Model Messages (YDOCMDLMSG), 5-18 Document Model Relations (YDOCMDLREL), 519 Document Unreferenced Objects (YDOCURF), 5-21 DSNSTD parameter YCRTMDLLIB command, 4-39 DSPFFD i OS command YRTVPFMDL command, 6-27 Duplicate Application Objects (YDUPAPPOBJ), 5-54

F
F4 prompt retrieve condition, 3-48 YCUAPMT model value, 3-48 field names YHLLVNM model value, 4-41 field reference file name (YFRFVNM) YSBMMDLCRT command, 6-38 Filter a Model Object List (YFLTMDLLST), 5-75

G
generating model objects YCRTJOBLE command, 4-33 generation library (YGENLIB) YCRTMDLLIB command, 4-38 YCVTCNDVAL command, 4-55 YCVTMDLMSG command, 4-66 YDUPAPPOBJ command, 5-54 YRNMMDL command, 6-9 generation types table YCVTMDLVNM command, 4-71

E
Edit Copy List (YEDTCPYLST), 5-56 Edit Default Display Attributes (YEDTDFTATR), 5-57 Edit Model (Y2), 6-51 Edit Model (YEDTMDL), 5-58 *DSNR User Type, 5-59 *PGMR User Type, 5-59 *USER User Type, 5-59 Edit Model Object List (YEDTMDLLST), 5-62 Edit Model Profile (YEDTMDLPRF), 5-66 Edit Next Mnemonics (YEDTNXTMNC), 5-67 Execute a Model Object List (YEXCMDLLST), 568 Execute SQL Statements (YEXCSQL), 5-74

H
HLL naming convention (YHLLVNM) YCRTMDLLIB command, 4-41 YCVTMDLVNM command, 4-71 HLL to generate (YHLLGEN) YCRTMDLLIB command, 4-41

I
impact analysis, 5-52 Index a Model List (YINXMDLLST), 5-89

J
job description (YCRTJBD)

Index3

YCRTMDLLIB command, 4-44 YRNMMDL command, 6-10 YSBMMDLCRT command, 6-35 job lists building, 3-11 checking entries, 3-68 Job lists YEDTMDL command, 5-59

model messages converting, 4-65 model object description YDSPMDLOD command, 5-27 model objects dependencies between, 5-30, 5-41 description, 5-27 generating, 4-33 references of, 5-30 usages of, 5-41 model values changing, 3-41 company text (YCMPTXT), 4-39 CUA prompt (YCUAPMT), 3-48 database access method (YDBFACC), 3-43 F4 prompting, 3-48 generate GUI by default (YGENGUI), 3-43 GUI command key descriptor text (YGUICMD), 3-43 GUI display command keys per tab (YGUITKY), 3-43 GUI help language (YGUIHLP), 3-43 GUI library partitioning (YGUILIB), 3-43 GUI objects folder (YGUIFLR), 3-43 GUI prefix/text operator (YGUIOPR), 3-43 GUI subfile select text (YGUISEL), 3-43 model text (YMDLTXT), 4-39 null update suppression (YNLLUPD), 3-44 prompting (F4), 3-48 share function subroutines (YSHRSBR), 344 SQL locking (YSQLLCK), 3-44 SQL naming (YSQLVNM), 3-45 SQL naming length (YSQLLEN), 3-44 SQL Where clause (YSQLWHR), 3-45 subfile end (YSFLEND), 3-44, 3-47 suppress aid keys (YGUIAKY), 3-43 suppress list options (YGUILSO), 3-43

L
library lists for models, 6-48 for Synon/2E, 4-43, 4-54 renaming, 6-8 Library lists YSTRY2 command, 6-47 LNG model value YCRTMDLLIB command, 4-42

M
member name prefix (YOBJPFX) copying objects, 4-28 YCRTMDLLIB command, 4-39 message file name (YMSGVNM) YCRTMDLLIB command, 4-41 YCVTMDLMSG command, 4-66 message file names, 4-66 defaults, 4-41 message id prefix (YMSGPFX) copying objects, 4-28 YCRTMDLLIB command, 4-40 message identifiers copying objects, 4-29 model data level, 3-9 model language (YMDLLNG) YAPYTRNMDL command, 3-10 model library (YMDLLIB) YCRTMDLLIB command, 4-38 YCVTMDLMSG command, 4-65

N
National Language library YAPYTRNMDL command, 3-9 YCRTMDLLIB command, 4-42, 4-45

Index4

Command Reference Guide

O
object YDSPMDLOD command, 5-27 old library (YOLDLIB) YSBMMDLCRT command, 6-38 Operate on a Model Object List (YOPRMDLLST), 5-92 i OS DBF files retrieving, 6-26

Retrieve Physical Files to Model (YRTVPFMDL), 6-25 RPG III generation field names, 4-41 specifying model values, 4-41 RPG III names YCVTMDLVNM command, 4-71

S
SAA YCRTMDLLIB command, 4-39 screen designs converting, 4-66 Select Version (YSLTVSN), 6-42 Set Model Object Copy Name (YSETCPYNME), 6-41 Start CA 2E (YSTRY2), 6-47 Start Change Control (YSTRCHGCTL), 6-44 Submit Model Create Requests (YSBMMDLCRT), 6-31 symbols action diagram, 3-46 compound condition, 3-46 compute expression, 3-46 Synchronize Model (YSNCMDL), 6-43 Synon/1E panel designs, 4-69 Synon/2E library lists, 4-43 Library lists, 4-54 Synon/2E Access Paths documenting, 5-1 Synon/2E Application Areas documenting, 5-3 Synon/2E Fields documenting, 5-7 Synon/2E Files documenting, 5-5 Synon/2E Functions

P
prompting (F4), 3-48 prototyping converting screen designs, 4-66

Q
QGPL library library list, 4-43 QTEMP library library list, 4-43

R
Redirect Model Object (YRDRMDLOBJ), 6-1 references of model objects YDSPMDLREF command, 5-30 Rename Model (YRNMMDL), 6-7 Reorganize Model (YRGZMDL), 6-6 reorganizing job lists, 6-6 retrieve condition, 3-48 Retrieve Model Profile details (YRTVMDLPRF), 6-20 Retrieve Model Value (YRTVMDLVAL), 6-24 Retrieve Object Description (YRTVMDLOBJ), 611

Index5

documenting, 5-8 Synon/2E Message Functions documenting, 5-18 Synon/2E Models clearing, 4-1 Synon/2E Shipped Source values list program, 4-56

Y2MSG message file YCPYMDLOBJ command, 4-25 YALCVNM (automatic name allocation) copying objects, 4-27 YAPYSYSMDL, 3-8 YBLDLIBLST (Build Library List), 6-48 Synon/1E Reference, 6-48 YBLDMDLLST (Build a Model Object List), 3-16

U
usages of model objects YDSPMDLUSG command, 5-41 user interface standards YCRTMDLLIB command, 4-40 user points F4 prompting, 3-48 retrieve condition, 3-48

YCPYLIB (copy library) YSBMMDLCRT command, 6-38 YCPYLIB model value YSBMMDLCRT, 6-39 YCRTDSNF, 4-69 Synon/1E Reference, 4-69 YCRTJBD (job description) YCRTMDLLIB command, 4-44 YRNMMDL command, 6-10, 6-27 YSBMMDLCRT command, 6-35 YDSPPNL (Display Panel), 4-69 Synon/1E Reference, 4-69 YEDTLIBLST (Edit Library List), 6-48 Synon/1E Reference, 6-48 YFRFVNM (field reference file name) YSBMMDLCRT command, 6-38 YGENLIB (generation library) YCRTMDLLIB command, 4-38 YCVTCNDVAL command, 4-55 YCVTMDLMSG command, 4-66 YDUPAPPOBJ command, 5-54 YRNMMDL command, 6-9 YGENLIB generation library YSBMMDLCRT command, 6-35 YHLLGEN (HLL to generate) YCRTMDLLIB command, 4-41 YHLLVNM (HLL naming convention) YCRTMDLLIB command, 4-41 YCVTMDLVNM command, 4-71 YMDLLIB (model library) YCRTMDLLIB command, 4-38 YCVTMDLMSG command, 4-65 YMDLLNG (model language)

V
Value List Prefix (YVLSPFX) YCRTMDLLIB command, 4-39 YCVTCNDVAL command, 4-56 values list display program, 4-56

W
Work Distributed Files (YWRKDSTFIL), 6-48 Work with Model Object Lists (YWRKMDLLST), 6-50

Y
Y2CALL (Call a Program), 6-56 Y2CFGTR program YWRKDSTFIL command, 6-49 Y2DSTFR program YWRKDSTFIL command, 6-49

Index6

Command Reference Guide

YAPYTRNMDL command, 3-10 YMDLLVLRFA data area, 3-7 YMDLLVLSYA data area, 3-7 YMDLNBRRFA data area[YMDLNBRRFA data area], 3-9 YMDLNBRSYA data area[YMDLNBRSYA data area], 3-9 YMSGPFX (message id prefix) copying objects, 4-28 YCRTMDLLIB command, 4-40 YMSGVNM (message file name) YCRTMDLLIB command, 4-41 YCVTMDLMSG command, 4-66 YOBJPFX (member name prefix) copying objects, 4-28 YCRTMDLLIB command, 4-39 YOLDLIB (old library) YSBMMDLCRT command, 6-38 YRTVPFMDL, 6-25 YRTVPHYR1C Shipped program[YRTVPHYR1C Shipped program], 6-29 YSYSHLL (default HLL) YCRTMDLLIB command, 4-41 YVLSPFX (value list prefix) YCRTMDLLIB command, 4-39 YCVTCNDVAL command, 4-56

Index7