Syntax
ATTRIBUTE BDNAME literal [ usercode ] [ GS status ]
Parameters
Attribute can be abbreviated as Attr.
BDNAME literal
Expression that holds the BDNAME attribute. Non-literal values must be terminated with a period (.). This is illustrated in the examples of this command.
The maximum length of the BDNAME is 180 characters. For a literal, the maximum length is 58 characters (56 characters if a usercode is supplied).
usercode
Literal that contains a usercode. If omitted, the file is produced with the same usercode with which the Report is running. The Report program must be privileged, or running under a privileged usercode, in order to produce a file under a different usercode (otherwise, the Report will terminate).
GS status
Indicates command status using the specified variable.
Description
The Attribute logic command is not supported on applications deployed to Windows.
Use this command for MCP-based systems to define the printer backup file names for your Report output. The command is available for ROC Direct Reports and non-ROC Reports directed to LP or RP devices.
The Attribute command enables you to define the BDNAME attribute – the (usercode) bdname portion of the printer backup filename – in similar fashion to the system command :BDD.
By default, the BDNAME attribute is LINCBD, although this might have been changed by using the System command :BDD. For standalone Reports, the default value is a period (.), which means the system default *BD is used.
About printer backup files
Printer backup files created by Reports are named:
(usercode)bdname/mix/counttitle
Where:
usercode is the usercode of the file
bdname is a prefix for the file name
mix is the seven-digit mix number of the Report
counttitle consists of count, a three-digit number, and title, the title of the file
Note: The printer backup file name is set when the file is opened. The Attribute command must therefore be executed before a print file is opened.
Errors
If the command cannot set the BDNAME attribute (for example, the syntax is not correct), the attribute is unchanged. The System attribute Glb.Status is not set by this command. Include the GS option to divert status messages to a variable.
There is no recovery of the BDNAME attribute. It is your responsibility to ensure that your change is saved and recovered.
If your Report is not running under a privileged usercode, exceeding the limit (180 characters) or creating an invalid file name (for example, of more than 14 levels) will result in your Report terminating with a fatal error.
Example
The following command sets BDNAME to *BD. This is equivalent to the System command :BDD. (Refer to the Agile Business Suite Runtime for ClearPath MCP Administration Guide for more information).
Attribute BdName "."
The following command sets BDNAME to PRINT/FILE/FOR/BILLING.
Attribute BdName "PRINT/FILE/FOR/BILLING"
The following command sets BDNAME to (USER1)LOCALPRINT.
Attribute BdName "LOCALPRINT" USER1
The following command sets BDNAME to REPORT/PRINTOUT.
BDNAMESD = "REPORT/PRINTOUT." Attribute BdName BDNAMESD