Ricoh InfoPrint Pro C900AFP InfoPrint Manager - Page 74

Compile and install your user-exit program, Notes, usr/lpp/psf/bin, Makefile, make install

Page 74 highlights

becomes part of the InfoPrint Manager executable code, a defective user-exit program could cause problems with InfoPrint Manager. Compile and install your user-exit program To compile and install your user-exit program, follow these steps: Notes: You must have root authority to use the make command in this directory. 1. If you already have an existing executable user-exit program in the /usr/lpp/psf/bin directory for the user-exit program you are adding, do these steps first; otherwise, go to step 2. a. Disable all the logical destinations associated with the queues that are to receive jobs that will use the new user-exit program. b. Delete the executable user-exit program from the /usr/lpp/psf/bin directory. 2. To make the directory in which the user-programs are stored the current directory, enter: cd /usr/lpp/psf/exits 3. On the AIX command line, enter: make The make command reads the Makefile file supplied with InfoPrint Manager, compiles and generates the user-exit program. 4. On the AIX command line, enter: make install The make install command copies the executable user-exit program from the /usr/lpp/psf/exits directory into the /usr/lpp/psf/bin directory so that the code executes with InfoPrint Manager. 5. Enable all of the logical destinations that you disabled. Notes: 1. If you do not want to copy the executable user-exit program into the /usr/lpp/psf/bin directory, you can copy them into another directory. However, if you do this, you need to add the path to the PATH statement in the /etc/environment file so that InfoPrint Manager can locate the module. 2. You can only specify one user-exit program for each function name provided by InfoPrint Manager per queue. 3. Make sure the function name of the user-exit is one of the following where the name is in uppercase letters, because that is the entry point in the module: v ACCOUNTING v AUDIT v JOBCOMPLETION v HEADER v SEPARATOR v TRAILER v INDATA v OUTDATA 4. If you do not want to use the same name for the user-exit program, you must edit the Makefile file and change the name of the user-exit program supplied with InfoPrint Manager to the new name. For example, to call your new header user-exit program header, you must edit the Makefile file and change the name of the existing header user-exit program, ainuxhdr to header. In addition, 60 InfoPrint Manager for AIX: Procedures

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
  • 128
  • 129
  • 130
  • 131
  • 132
  • 133
  • 134
  • 135
  • 136
  • 137
  • 138
  • 139
  • 140
  • 141
  • 142
  • 143
  • 144
  • 145
  • 146
  • 147
  • 148
  • 149
  • 150
  • 151
  • 152
  • 153
  • 154
  • 155
  • 156
  • 157
  • 158
  • 159
  • 160
  • 161
  • 162
  • 163
  • 164
  • 165
  • 166
  • 167
  • 168
  • 169
  • 170
  • 171
  • 172
  • 173
  • 174
  • 175
  • 176
  • 177
  • 178
  • 179
  • 180
  • 181
  • 182
  • 183
  • 184
  • 185
  • 186
  • 187
  • 188
  • 189
  • 190
  • 191
  • 192
  • 193
  • 194
  • 195
  • 196
  • 197
  • 198
  • 199
  • 200
  • 201
  • 202
  • 203
  • 204
  • 205
  • 206
  • 207
  • 208
  • 209
  • 210
  • 211
  • 212
  • 213
  • 214
  • 215
  • 216
  • 217
  • 218
  • 219
  • 220
  • 221
  • 222
  • 223
  • 224
  • 225
  • 226
  • 227
  • 228
  • 229
  • 230
  • 231
  • 232
  • 233
  • 234
  • 235
  • 236
  • 237
  • 238
  • 239
  • 240
  • 241
  • 242
  • 243
  • 244
  • 245
  • 246
  • 247
  • 248
  • 249
  • 250
  • 251
  • 252
  • 253
  • 254
  • 255
  • 256
  • 257
  • 258
  • 259
  • 260
  • 261
  • 262
  • 263
  • 264
  • 265
  • 266
  • 267
  • 268
  • 269
  • 270
  • 271
  • 272
  • 273
  • 274
  • 275
  • 276
  • 277
  • 278
  • 279
  • 280
  • 281
  • 282
  • 283
  • 284
  • 285
  • 286
  • 287
  • 288
  • 289
  • 290
  • 291
  • 292
  • 293
  • 294
  • 295
  • 296
  • 297
  • 298
  • 299
  • 300
  • 301
  • 302
  • 303
  • 304
  • 305
  • 306
  • 307
  • 308
  • 309
  • 310
  • 311
  • 312
  • 313
  • 314
  • 315
  • 316
  • 317
  • 318
  • 319
  • 320
  • 321
  • 322
  • 323
  • 324
  • 325
  • 326
  • 327
  • 328
  • 329
  • 330
  • 331
  • 332
  • 333
  • 334
  • 335
  • 336
  • 337
  • 338
  • 339
  • 340
  • 341
  • 342
  • 343
  • 344
  • 345
  • 346
  • 347
  • 348
  • 349
  • 350
  • 351
  • 352
  • 353
  • 354
  • 355
  • 356
  • 357
  • 358
  • 359
  • 360
  • 361
  • 362
  • 363
  • 364
  • 365
  • 366
  • 367
  • 368
  • 369
  • 370
  • 371
  • 372
  • 373
  • 374
  • 375
  • 376
  • 377
  • 378
  • 379
  • 380
  • 381
  • 382
  • 383
  • 384
  • 385
  • 386
  • 387
  • 388
  • 389
  • 390
  • 391
  • 392
  • 393
  • 394
  • 395
  • 396
  • 397
  • 398
  • 399
  • 400
  • 401
  • 402
  • 403
  • 404
  • 405
  • 406
  • 407
  • 408
  • 409
  • 410
  • 411
  • 412
  • 413
  • 414
  • 415
  • 416
  • 417
  • 418

becomes part of the InfoPrint Manager executable code, a defective user-exit
program could cause problems with InfoPrint Manager.
Compile and install your user-exit program
To compile and install your user-exit program, follow these steps:
Notes:
You must have
root
authority to use the
make
command in this directory.
1.
If you already have an existing executable user-exit program in the
/usr/lpp/psf/bin
directory for the user-exit program you are adding, do these
steps first; otherwise, go to step 2.
a.
Disable all the logical destinations associated with the queues that are to
receive jobs that will use the new user-exit program.
b.
Delete the executable user-exit program from the
/usr/lpp/psf/bin
directory.
2.
To make the directory in which the user-programs are stored the current
directory, enter:
cd /usr/lpp/psf/exits
3.
On the AIX command line, enter:
make
The
make
command reads the
Makefile
file supplied with InfoPrint Manager,
compiles and generates the user-exit program.
4.
On the AIX command line, enter:
make install
The
make install
command copies the executable user-exit program from the
/usr/lpp/psf/exits
directory into the
/usr/lpp/psf/bin
directory so that the code
executes with InfoPrint Manager.
5.
Enable all of the logical destinations that you disabled.
Notes:
1.
If you do not want to copy the executable user-exit program into the
/usr/lpp/psf/bin
directory, you can copy them into another directory. However,
if you do this, you need to add the path to the
PATH
statement in the
/etc/environment
file so that InfoPrint Manager can locate the module.
2.
You can only specify one user-exit program for each function name provided
by InfoPrint Manager per queue.
3.
Make sure the function name of the user-exit is one of the following where the
name is in uppercase letters, because that is the entry point in the module:
v
ACCOUNTING
v
AUDIT
v
JOBCOMPLETION
v
HEADER
v
SEPARATOR
v
TRAILER
v
INDATA
v
OUTDATA
4.
If you do not want to use the same name for the user-exit program, you must
edit the
Makefile
file and change the name of the user-exit program supplied
with InfoPrint Manager to the new name. For example, to call your new header
user-exit program
header
, you must edit the
Makefile
file and change the
name of the existing header user-exit program,
ainuxhdr
to
header
. In addition,
60
InfoPrint Manager for AIX: Procedures