Resource Compiler - Syntax

Syntax

The irc command line entry has the following syntax:

irc [options] resource_script_file [resource_file]

where:

resource_script_file 
The filename of the resource script file to be compiled. If the file is not in the current directory, you must provide a full path. If you provide a filename without specifying a filename extension, irc automatically appends the .rc extension to the name.
resource_file
The name of the binary resource file to be created. If resource_file is not specified, the base name of the resource file defaults to the base name of the input resource script file.

If the binary resource file does not already exist, irc creates it; otherwise, irc replaces the existing file. If the file is not in the current directory, you must provide a full path.

The binary resource file must have the .res filename extension.

Options
The following options can be specified on the Resource Compiler command line:

Option Description
-Ddefname[=value]
Define macro to preprocessor.

This option is useful for passing conditional compilation flags to the preprocessor.

defname is any sequence of letters, underscore symbols, and digits which does not begin with a digit.

value is a sequence of symbols which you want to substitute for the defname wherever it appears in the input script file. If you omit =value, the value of defname will default to 1. For example, the option -D_3d is equivalent to including the following at the beginning of the input file:

#define _3d 1

You can use the -D option up to 8 times to define different macros from the command line.

-h
-?
Access Help

These options cause the Resource Compiler to display a help summary of available options. When you use the -h or -? options, the Resource Compiler does not read any input files.

Entering irc on the command line with no operands also displays the help summary, shown below.

irc (IBM Resource Compiler) Version 5.00.000 Oct 6 1997
Copyright (C) IBM Corp. 1997.
- Licensed Materials - Program Property of IBM - All Rights Reserved.
US Government Users Restricted Rights - Use, duplication or disclosure
restricted by GSA ADP Schedule Contract with IBM Corp.


irc [<options>] <.rc input file> [<.res output file>]
Options: -D<defname> - Preprocessor define
-I<path> - Include file path
-lang language - language
-n - Don't show logo
-z - Ignore os2.h
-w[1|2|4] - Suppress warnings
-? - Access Help
-h - Access Help
-Ipath
Include file path.

This option defines paths for files to be included with the source file. The path is any path where you want irc to search for files included by the preprocessor #include directive. The path must not contain embedded blanks. To include more than one path, code the -I option once for each path.

-langlanguage
Language

The -lang option specifies the language in which the resource script is compiled. The value of language is a POSIX locale.

-w
-w1
-w2
-w4
Suppress the display of all or selected levels of warning and informational messages.
-z
Ignore os.h header file.

This option aids portability between AIX and OS/2 compilation environments. It causes the Resource Compiler to ignore the os.h header file which is valid in the OS/2 environment, but not available for AIX.



Resource Compiler - Examples


Resource Compiler - An Overview
Resource Compiler - Resource Script Files