Dtl_write_w_idx – Rockwell Automation 1771-DMC_DMC1_DMC4_DXPS Control Coprocessor User Manual User Manual

Page 216

Advertising
background image

API Library of Routines

Appendix B

DTL_WRITE_W_IDX

B-85

Writes to any elements of a file, one element at a time, from the
control-coprocessor memory to the PLC-5 programmable controller using
only one data definition.

Important: To use this function call, you must have the versions of the
ABLIB.L and CORPRO.H files that accompany Series A Revision D
(1.20) or later of the Program Development Software. Contact Allen-
Bradley Global Technical Support Services at (216) 646-6800 if you need
these updates.

C Syntax

#include <copro.h>

unsigned DTL_WRITE_W_IDX (name_id, variable, iostat, index)

unsigned name_id;

void *variable;
unsigned *iostat;
unsigned index;

Parameters

name_id

DTL_C_DEFINE returns this handle when the data file to be written
is defined.

variable

The address of a buffer that contains the data to be written to the PLC-5
programmable controller. Ensure that the declared variable is the right
type to match the data size that was specified in DTL_C_DEFINE.

iostat

Returns a final completion status. Possible completion status values are:

Value

Meaning

0

DTL_SUCCESS = operation completed successfully

27

DTL_E_NOATMPT = I/O operation not attempted; see status variable for reason

xxx

¬

PCCC_E_xxx = operation refused by the PLCĆ5 programmable controller

¬

See Table B.A for PCCC errors.

index

This parameter specifies the element or structure level of the data-file
item to be written.

DTL_WRITE_W_IDX

Advertising