Index

ADDOBJCNT

ADDOBJCNT/OBJ

ADDOBJCNT/TOLEVEL

ADDOBJCNT/LNG

ADDOBJCNT/CMP

ADDOBJCNT/GRP

ADDOBJCNT/USR

ADDOBJCNT/LSTCNT

ADDOBJCNT/LIB

ADDOBJCNT/DSP

ADDOBJCNT/FMT

ADDOBJCNT/FLD

ADDOBJCNT/FMTTYPE

ADDOBJCNT/FLDTYPE

ADDOBJCNT/FLDTYPECN

ADDOBJCNT/FLDUSE

ADDOBJCNT/FLDLEN

ADDOBJCNT/FLDDEC

ADDOBJCNT/REFFLDLIB

ADDOBJCNT/REFFLDFIL

ADDOBJCNT/REFFLDFMT

ADDOBJCNT/REFFLD

ADDOBJCNT/CONSTVALUE

ADDOBJCNT/OPTIND

ADDOBJCNT/COMMAND/EXAMPLES

ADDOBJCNT/ERROR/MESSAGES

DYNAMICLIST

CMDCMP

The Add Object Connection (ADDOBJCNT) command connects an object to all format or field matching the selection criteria. By default, all format or field are selected.

Nota: If many field or format are going to be connected to the object, it is advised to submit this command to a batch job.

Restrictions:

Object (OBJ)

Specifies the object to be connected. An object could be a simple grafical feature, a control or a sofisticated feature with link or image or system-command and reacting to Event such as click, right-click etc...

Nota: To define new OBJECT use the cmd: IWEB/DFNOBJ

This is a required parameter.

Qualifier 1: Object

*DDSSRC
*DDSSRC can be used only when the cmd is specified within a DDS source. To specify this cmd within a DDS source you have to use the following format, in completition of the cmd statement DFNOBJ: 

     A          R FMT1
     A . . .
      *%%IW CRTOBJDFN OBJ(*DDSSRC)
      *%%IW           OBJTYPE(...)
      *%%IW           . . .
      *%%IW ADDOBJCNT OBJ(*DDSSRC)
      *%%IW           TOLEVEL(*DDSSRC)
     A . . .

The parameter value *DDSSRC assume the format or field name preceding the command insertion, like does any DDS keyword.

Nota: To insert the cmd within a DDS source, type-in the cmd in another session, use F14=cmd string and then do a copy/past to the DDS source.

name
Specify the name of the object you want to connect.

Qualifier 2: Collection

DEFAULT
The collection named DEFAULT is used. (Collections are object's containers.)
name
Specify the name of the collection which contain the object you want to connect.

Nota: To define new COLLECTION use the cmd: IWEB/CRTCLC

To level (TOLEVEL)

Specifies the level to which the object will be connected. (record-format or field level)

This is a required parameter.

*FORMAT
The connection will occur at the record-format level.
*FIELD
The connection will occur at the field level.
*DDSSRC
The connection will occur at the DDS source statement level. (This value is valid only if the cmd is inserted within the DDS source)

Language (LNG)

Specifies the language to which the connection will occur. By default all language are included.

character-value
Specify the language ID to which the connection will occur.

Nota: You may promt (F4) this parameter to get a positionable dymanic list.

Company (CMP)

Specifies the company (if your application uses it as a information system) to which the connection will occur. By default all companies are included.

character-value
Specify the company ID to which the connection will occur.

Nota: To add, remove, get or set companies (as information system) use company's commands and session programs.

Nota: You may promt (F4) this parameter to get a positionable dymanic list.

User group (GRP)

Specifies the user-group to which the connection will occur. By default all user-group are included.

character-value
Specify the user-group ID to which the connection will occur.

Nota: You may promt (F4) this parameter to get a positionable dymanic list.

User (USR)

Specifies the user-profil to which the connection will occur. By default all user-profil are included.

character-value
Specify the user-profil ID to which the connection will occur.

Nota: You may promt (F4) this parameter to get a positionable dymanic list.

List format/field connected (LSTCNT)

Specifies if you want to list all format or field resulting connected by the cmd. You can either display the list or print it.

*NONE
No list of format or field connected is generated.
*
The list of format or field connected is display at the end of the process.
*PRINT
The list of format or field connected is printed at the end of the process.

Library (LIB)

Specifies the library to which the connection will occur.

This is a required parameter.

character-value
Specify the name of a library.

Nota: You may promt (F4) this parameter to get a positionable dymanic list.

Display (DSP)

Specifies the display name as a selection criteria. By default all display are included.

character-value
Specify the display name. (you can use %wild%card% expression as the LIKE SQL statement does)

Nota: You may promt (F4) this parameter to get a positionable dymanic list.

Format (FMT)

Specifies the format name as a selection criteria. By default all format are included.

character-value
Specify the format name. (you can use %wild%card% expression as the LIKE SQL statement does)

Nota: You may promt (F4) this parameter to get a positionable dymanic list.

Field (FLD)

Specifies the field name as a selection criteria. By default all field are included.

character-value
Specify the field name. (you can use %wild%card% expression as the LIKE SQL statement does)

Nota: You may promt (F4) this parameter to get a positionable dymanic list.

Format type (FMTTYPE)

Specifies the type of record-format as a selection criteria. By default all type of record-format are included.

You can specify 4 values for this parameter.

NORMAL
Only NORMAL record-format type will be selected.
SFL
Only SFL record-format type will be selected.
SFLMSG
Only SFLMSG record-format type will be selected.
SFLCTL
Only SFLCTL record-format type will be selected.
WINDOW
Only WINDOW record-format type will be selected.

Field type (FLDTYPE)

Specifies the type of field as a selection criteria. By default all type of field are included.

You can specify 20 values for this parameter.

A
Alphanumeric shift - Character
D
Digits only - Character or numeric
F
Floating point - Numeric
I
Inhibit keyboard entry - Character or numeric
M
Numeric only character - Character
N
Numeric shift - Character or numeric
S
Signed numeric - Numeric
W
Katakana (for Japan only) - Character
X
Alphabetic only - Character
Y
Numeric only - Numeric
E
DBCS-either field
J
DBCS-only field
O
DBCS-open field
G
DBCS-graphic field
img
(reserved to iWeb command)
const
Constant field
help
Help field
obj
(reserved to iWeb command)

Field simplified type Char-Num (FLDTYPECN)

Specifies the simplified field type (Character or Numeric) as a selection criteria. By default all type of field are included.

C
Character
N
Numeric

Field use (FLDUSE)

Specifies the field usage as a selection criteria. By default all field usage are included.

You can specify 6 values for this parameter.

I
Input field
O
Output field
B
Both usage field
H
Hidden field
P
Program-to-system field
M
Message field

Field length (FLDLEN)

Specifies the length field range as a selection criteria. By default all length field are included.

Element 1: From

From length value
decimal-number
Specify the number of the minimum field length

Element 2: To

To length value
decimal-number
Specify the number of the maximum field length

Field decimal position (FLDDEC)

Specifies the length decimal range as a selection criteria. By default all decimal length are included.

Element 1: From

From length value
decimal-number
Specify the number of the minimun decimal length

Element 2: To

To length value
decimal-number
Specify the number of the maximum decimal length

Reference field library (REFFLDLIB)

Specifies the reference field library name as a selection criteria. By default all reference field library are included.

character-value
Specify the reference field library name (You can use %wild%card% expression as the LIKE SQL statement does)

Reference field display (REFFLDFIL)

Specifies the reference field file name as a selection criteria. By default all reference field file are included.

character-value
Specify the reference field file name (you can use %wild%card% expression as the LIKE SQL statement does)

Reference field format (REFFLDFMT)

Specifies the reference field record-format name as a selection criteria. By default all reference field record-format are included.

character-value
Specify the reference field record-format name (you can use %wild%card% expression as the LIKE SQL statement does)

Reference field (REFFLD)

Specifies the reference field name as a selection criteria. By default all reference field are included.

character-value
Specify the reference field name (you can use %wild%card% expression as the LIKE SQL statement does)

'Constant' %wild%card% text (CONSTVALUE)

Specifies a constant value as a selection criteria. By default all constant are included.

You can specify 100 values for this parameter.

character-value
Specify the constant value (you can use %wild%card% expression as the LIKE SQL statement does)

Option indicators connection (OPTIND)

Specifies option indicators to select a connection at run time. Your program can set option indicators ON or OFF and condition the connection.

Nota: Only original option indicators from the DDS record-format will be controlled by the runtime process of iWeb. If you need extra indicators you may describe them first within your DDS source code, even for dummy field or keyword: (A__12N12___________________________1__2'_')

You can specify 100 values for this parameter.

Element 1: Indicator

01-99
Indicator ON: 01-99, Indicator OFF: N01-N99

Element 2: Indicator

01-99
Indicator ON: 01-99, Indicator OFF: N01-N99

Element 3: Indicator

01-99
Indicator ON: 01-99, Indicator OFF: N01-N99

Element 4: Operator

AND
Operator AND between current list and next list.
OR
Operator OR between current list and next list.

Examples for ADDOBJCNT

Example 1: Simple Command Example 

ADDOBJCNT  KWD1(PARMVAL1)

This command <...>

Example 2: More Complex Command Example 

ADDOBJCNT   KWD1(PARMVAL1)  KWD2(PARMVAL2)
            KWD3(PARMVAL3)

This command <...>

Error messages for ADDOBJCNT

*ESCAPE Messages

CPF9801
Object &2 in library &3 not found.
CPF9802
Not authorized to object &2 in &3.
CPF9803
Cannot allocate object &2 in library &3.
CPF9807
One or more libraries in library list deleted.
CPF9808
Cannot allocate one or more libraries on library list.
CPF9810
Library &1 not found.
CPF9811
Program &1 in library &2 not found.
CPF9812
File &1 in library &2 not found.
CPF9820
Not authorized to use library &1.
CPF9830
Cannot assign library &1.
CPF9899
Error occurred during processing of command.

You may prompt (F4) this parameter to get a dynamic list of 100 elements at a time.

If the list contains more than 100 elements, the last element will be substitued with the string " ...More". You can therefore position the list inserting a character string followed by the "+" symbol. (for example, with "MXY+" the list will start from "MXY").

Company (as Information System) control commands and programs: